home *** CD-ROM | disk | FTP | other *** search
/ Libris Britannia 4 / science library(b).zip / science library(b) / GRAPHICS / GRAPHUTL / 1768.ZIP / GRASP2.ZIP / GRASP.MAN < prev    next >
Encoding:
Text File  |  1986-08-12  |  115.2 KB  |  5,545 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.                                      G R A S P
  17.  
  18.                          GRAphical System for Presentation
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.                            Another USEware product from:
  51.  
  52.                              Microtex Industries, Inc.
  53.                             2091 Business Center Drive
  54.                                 Irvine, Ca.  92715
  55.                                   (714) 476-0777
  56.  
  57.                     (714) 545-8100 - PCPaint Picture Swap Line
  58.  
  59.         Current release number: 1.10            Current release date :08/86
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.  
  73.  
  74.  
  75.  
  76.  
  77.  
  78.  
  79.  
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.                              GRASP - Table of Contents
  126.                              =========================
  127.  
  128.     Overview of Product  . . . . . . . . . . . . . . . . . . . . . . .    1
  129.  
  130.          What is GRASP?  . . . . . . . . . . . . . . . . . . . . . . .    3
  131.          What is on the GRASP disk?  . . . . . . . . . . . . . . . . .    4
  132.          Making a working copy of the GRASP disk . . . . . . . . . . .    6
  133.          Installing GRASP  . . . . . . . . . . . . . . . . . . . . . .    7
  134.          GRASP Installation Diagram  . . . . . . . . . . . . . . . . .    8
  135.          How do I use GRASP? . . . . . . . . . . . . . . . . . . . . .    9
  136.          Running GRASP . . . . . . . . . . . . . . . . . . . . . . . .   10
  137.          The Grasp Editor  . . . . . . . . . . . . . . . . . . . . . .   12
  138.          Simple GRASP Tutorial . . . . . . . . . . . . . . . . . . . .   15
  139.          Running the library file version - GRASPRT  . . . . . . . . .   18
  140.          Using the GRASP Graphics Librarian - GLIB . . . . . . . . . .   19
  141.  
  142.     The commands of GRASP - Detailed . . . . . . . . . . . . . . . . .   21
  143.  
  144.          BOX . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   23
  145.          CFADE . . . . . . . . . . . . . . . . . . . . . . . . . . . .   24
  146.          CFREE . . . . . . . . . . . . . . . . . . . . . . . . . . . .   25
  147.          CHGCOLOR  . . . . . . . . . . . . . . . . . . . . . . . . . .   26
  148.          CIRCLE  . . . . . . . . . . . . . . . . . . . . . . . . . . .   27
  149.          CLEARSCR  . . . . . . . . . . . . . . . . . . . . . . . . . .   28
  150.          CLOAD . . . . . . . . . . . . . . . . . . . . . . . . . . . .   29
  151.          COLOR . . . . . . . . . . . . . . . . . . . . . . . . . . . .   30
  152.          EXEC  . . . . . . . . . . . . . . . . . . . . . . . . . . . .   31
  153.          EXIT  . . . . . . . . . . . . . . . . . . . . . . . . . . . .   32
  154.          FFREE . . . . . . . . . . . . . . . . . . . . . . . . . . . .   33
  155.          FGAPS . . . . . . . . . . . . . . . . . . . . . . . . . . . .   34
  156.          FLOAD . . . . . . . . . . . . . . . . . . . . . . . . . . . .   35
  157.          FLOAT . . . . . . . . . . . . . . . . . . . . . . . . . . . .   36
  158.          FLY . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   37
  159.          FSTYLE  . . . . . . . . . . . . . . . . . . . . . . . . . . .   38
  160.          GOSUB . . . . . . . . . . . . . . . . . . . . . . . . . . . .   39
  161.          GOTO  . . . . . . . . . . . . . . . . . . . . . . . . . . . .   40
  162.          IFKEY . . . . . . . . . . . . . . . . . . . . . . . . . . . .   41
  163.          LINE  . . . . . . . . . . . . . . . . . . . . . . . . . . . .   42
  164.          LINK  . . . . . . . . . . . . . . . . . . . . . . . . . . . .   43
  165.          LOOP  . . . . . . . . . . . . . . . . . . . . . . . . . . . .   44
  166.          MARK  . . . . . . . . . . . . . . . . . . . . . . . . . . . .   45
  167.          MODE  . . . . . . . . . . . . . . . . . . . . . . . . . . . .   46
  168.          MOVE  . . . . . . . . . . . . . . . . . . . . . . . . . . . .   48
  169.          NOISE . . . . . . . . . . . . . . . . . . . . . . . . . . . .   49
  170.          OFFSET  . . . . . . . . . . . . . . . . . . . . . . . . . . .   50
  171.          PALETTE . . . . . . . . . . . . . . . . . . . . . . . . . . .   51
  172.          PAN . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   52
  173.          PFADE   . . . . . . . . . . . . . . . . . . . . . . . . . . .   53
  174.          PFREE   . . . . . . . . . . . . . . . . . . . . . . . . . . .   54
  175.          PLOAD . . . . . . . . . . . . . . . . . . . . . . . . . . . .   55
  176.          POINT   . . . . . . . . . . . . . . . . . . . . . . . . . . .   56
  177.  
  178.                                           i
  179.  
  180.  
  181.  
  182.  
  183.  
  184.          POSITION  . . . . . . . . . . . . . . . . . . . . . . . . . .   57
  185.          PUTUP . . . . . . . . . . . . . . . . . . . . . . . . . . . .   58
  186.          RECT  . . . . . . . . . . . . . . . . . . . . . . . . . . . .   59
  187.          RESETSCR  . . . . . . . . . . . . . . . . . . . . . . . . . .   60
  188.          RETURN  . . . . . . . . . . . . . . . . . . . . . . . . . . .   61
  189.          SETCOLOR  . . . . . . . . . . . . . . . . . . . . . . . . . .   62
  190.          SETUPSCR  . . . . . . . . . . . . . . . . . . . . . . . . . .   63
  191.          TEXT  . . . . . . . . . . . . . . . . . . . . . . . . . . . .   64
  192.          TILE  . . . . . . . . . . . . . . . . . . . . . . . . . . . .   65
  193.          TRAN  . . . . . . . . . . . . . . . . . . . . . . . . . . . .   66
  194.          VIDEO . . . . . . . . . . . . . . . . . . . . . . . . . . . .   67
  195.          WAITKEY . . . . . . . . . . . . . . . . . . . . . . . . . . .   69
  196.          WINDOW  . . . . . . . . . . . . . . . . . . . . . . . . . . .   70
  197.  
  198.     Tips, Hints, Examples and Demo Programs  . . . . . . . . . . . . .   71
  199.  
  200.          Example Program #1 - Slide Show . . . . . . . . . . . . . . .   73
  201.          Example Program #2 - How to animate using FLY . . . . . . . .   74
  202.  
  203.     APPENDIX A - Command Summary . . . . . . . . . . . . . . . . . . .   75
  204.  
  205.     APPENDIX B - Fade Table  . . . . . . . . . . . . . . . . . . . . .   77
  206.  
  207.     APPENDIX C - Error Messages  . . . . . . . . . . . . . . . . . . .   79
  208.  
  209.     APPENDIX D - Picture Swap Line . . . . . . . . . . . . . . . . . .   83
  210.  
  211.     APPENDIX E - GRASP Order Form  . . . . . . . . . . . . . . . . . .   85
  212.  
  213.  
  214.  
  215.  
  216.  
  217.  
  218.  
  219.  
  220.  
  221.  
  222.  
  223.  
  224.  
  225.  
  226.  
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.                                          ii
  238.  
  239.  
  240.  
  241.  
  242.  
  243.                                 Overview of Product
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.  
  269.  
  270.  
  271.  
  272.  
  273.  
  274.  
  275.  
  276.  
  277.  
  278.  
  279.  
  280.  
  281.  
  282.  
  283.  
  284.  
  285.  
  286.  
  287.  
  288.  
  289.  
  290.  
  291.  
  292.  
  293.  
  294.  
  295.  
  296.                    GRASP - Graphical System for Presentation
  297.                                    Page:  1
  298.  
  299.  
  300.  
  301.  
  302.  
  303.  
  304.                         This page intentionally left blank
  305.  
  306.  
  307.  
  308.  
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.  
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.  
  335.  
  336.  
  337.  
  338.  
  339.  
  340.  
  341.  
  342.  
  343.  
  344.  
  345.  
  346.  
  347.  
  348.  
  349.  
  350.  
  351.  
  352.  
  353.  
  354.  
  355.  
  356.  
  357.                    GRASP - Graphical System for Presentation
  358.                                    Page:  2
  359.  
  360.  
  361.  
  362.  
  363.  
  364.  
  365.  
  366.                                   What is GRASP?
  367.  
  368.         GRASP is a simple graphics programming pseudo-language which can be
  369.         used to create and run animated graphics demonstrations, tutorials,
  370.         and  presentations  on  an  IBM  PC/XT/AT or respective compatible.
  371.         GRASP requires that the user make use of  some other  tool, such as
  372.         Mouse Systems'  PCPAINT PLUS, to create PCPAINT PLUS packed page or
  373.         BSAVE format pictures, or 'capture' screens from any other graphics
  374.         software with  the provided  capture utility  program. This product
  375.         was developed by the folks at  Microtex Industries,  the authors of
  376.         PCPAINT PLUS, so it is patterned to take advantage of the pictures,
  377.         clippings and fonts  created  with  PCPAINT  PLUS  and  its related
  378.         utilities, like FONTASIA and ARTOOLS.
  379.  
  380.         GRASP was  designed to  be the  base for many other products. GRASP
  381.         files can be generated by programs  written in  virtually any other
  382.         language. This  allows great flexibility to users in many different
  383.         areas. It is  this  flexibility  that  sets  GRASP  apart  from its
  384.         competitors. GRASP  in its  raw form,  as you  have it here, is not
  385.         indended to be a  user-friendly,  end-user  tool.  It  is, however,
  386.         simple enough  that any  user can  quickly learn  how to manipulate
  387.         GRASP files with ease.
  388.  
  389.  
  390.         Features:
  391.  
  392.         * Supports IBM CGA, IBM EGA, HERCULES, AST ColorGraphPlus,
  393.           Plantronics, AST Preview, 3 text modes.
  394.  
  395.         * 16 Picture Buffers
  396.  
  397.         * 128 Clipping Buffers
  398.  
  399.         * Single command to control animation sequences
  400.  
  401.         * 25 different fades with limitless combinations
  402.  
  403.         * Simple ASCII file format
  404.  
  405.         * FONTRIX(tm) font compatible
  406.  
  407.         * Fully PCPAINT PLUS from MOUSE SYSTEMS(tm) compatible
  408.  
  409.         * Run Custom Programs from within GRASP program
  410.  
  411.  
  412.         GRASP is NOT public domain. It is USEWARE, which means  that if you
  413.         use it,  you should  pay for  it. I make it available to the public
  414.         because I believe you have the right to try software before you buy
  415.         it. Please  do not  assume that this software is free for everyone.
  416.         Unauthorized use is punishable by law! - D. Wolfgram
  417.  
  418.                    GRASP - Graphical System for Presentation
  419.                                    Page:  3
  420.  
  421.  
  422.  
  423.  
  424.  
  425.  
  426.  
  427.  
  428.  
  429.  
  430.  
  431.  
  432.  
  433.  
  434.  
  435.  
  436.  
  437.  
  438.  
  439.  
  440.  
  441.  
  442.  
  443.  
  444.  
  445.  
  446.  
  447.  
  448.  
  449.  
  450.  
  451.  
  452.  
  453.  
  454.  
  455.  
  456.  
  457.  
  458.  
  459.  
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466.  
  467.  
  468.  
  469.  
  470.  
  471.  
  472.  
  473.  
  474.  
  475.  
  476.  
  477.  
  478.  
  479.                    GRASP - Graphical System for Presentation
  480.                                    Page:  4
  481.  
  482.  
  483.  
  484.  
  485.  
  486.  
  487.                             What is on the GRASP disk?
  488.  
  489.  
  490.         The following files are on the GRASP disk
  491.  
  492.         GRASP.EXE -
  493.  
  494.         This is the main GRASP program.  This   version  of GRASP  gets the
  495.         pictures, character  sets, clippings  and text  files it needs from
  496.         the current directory on your current disk drive,  unless otherwise
  497.         specified in  the text  files. This  program allows  you to create,
  498.         edit and execute your GRASP programs.
  499.  
  500.         GRASPRT.EXE - 
  501.  
  502.         This is the run-time version of GRASP. This  version of  GRASP gets
  503.         the pictures,  character sets,  clippings, and text it needs from a
  504.         graphics library  created with  the GRASP  graphics librarian GLIB.
  505.         This version only allows you to execute completed programs that are
  506.         in library form. No  editing of  the files  is possible.  This .EXE
  507.         file, along  with your .GL file, may be distributed without license
  508.         fees or other compensation.
  509.  
  510.         GLIB.COM - 
  511.  
  512.         Library  manager  for  version  GRASPRT  of  GRASP  product. Allows
  513.         management of  all necessary  files in a library environment rather
  514.         than as files in a subdirectory on a disk. 
  515.  
  516.         CAP.COM -
  517.  
  518.         Capture program for capturing screens and  clippings from  all your
  519.         favorite software.
  520.  
  521.         WHATPIC.EXE - 
  522.  
  523.         Utility program to determine size and color combinations of PCPAINT
  524.         PLUS pictures.
  525.  
  526.         WHATCLP.EXE - 
  527.  
  528.         Utility program to determine size and color combinations of PCPAINT
  529.         PLUS clippings.
  530.  
  531.         *.SET -
  532.  
  533.         Some fonts for you to use in your demo.  
  534.  
  535.         *.HLP -
  536.  
  537.         Various help files.
  538.  
  539.  
  540.                    GRASP - Graphical System for Presentation
  541.                                    Page:  5
  542.  
  543.  
  544.  
  545.  
  546.  
  547.  
  548.         GRASP.PIC -
  549.  
  550.         A 4 color CGA picture to use for testing and learning about GRASP.
  551.  
  552.         ALLFADES.TXT -
  553.  
  554.         A sample  GRASP text  file that uses GRASP.PIC and demonstrates all
  555.         the different fades.
  556.  
  557.         GRASP.MAN -
  558.  
  559.         The GRASP manual. You are reading it right now!
  560.  
  561.         CAP.MAN -
  562.  
  563.         A short manual on CAP, the resident capture utility.
  564.  
  565.  
  566.  
  567.  
  568.  
  569.  
  570.  
  571.  
  572.  
  573.  
  574.  
  575.  
  576.  
  577.  
  578.  
  579.  
  580.  
  581.  
  582.  
  583.  
  584.  
  585.  
  586.  
  587.  
  588.  
  589.  
  590.  
  591.  
  592.  
  593.  
  594.  
  595.  
  596.  
  597.  
  598.  
  599.  
  600.  
  601.                    GRASP - Graphical System for Presentation
  602.                                    Page:  6
  603.  
  604.  
  605.  
  606.  
  607.  
  608.  
  609.                       Making a working copy of the GRASP disk
  610.  
  611.  
  612.         The GRASP disk is not copy protected in any way. You should back up
  613.         the disk  using the DOS diskcopy command, or you may perform a file
  614.         by file backup to a hard disk using the DOS copy command. There are
  615.         several different  ways to  copy disks under DOS, but the following
  616.         will  work  on  almost  any  hardware  configuration  since  all it
  617.         requires is access to the DOS master disk and 1 floppy disk drive.
  618.  
  619.         For PCs with 1 or 2 floppys, or an XT or AT with 1 floppy:
  620.  
  621.         Put your  DOS master  disk in  drive A  and turn  on the machine or
  622.         press CTRL-ALT-DEL to re-boot the system.  Enter the  Date and Time
  623.         when prompted and you should see the system prompt:
  624.  
  625.         A>_
  626.  
  627.         Type:
  628.  
  629.         A>DISKCOPY A: A:
  630.  
  631.         and press  the return  key. You  will be prompted to put the SOURCE
  632.         disk in drive A. Remove the DOS master disk from  drive A,  put the
  633.         GRASP distribution  disk in,  close the  door and  press the return
  634.         key. After it reads some information, DOS will  ask you  to put the
  635.         TARGET disk in drive A. Put a blank disk (formatted or unformatted)
  636.         into drive A, close the door and press return. If  your machine has
  637.         less than  512K of memory, you may be prompted to perform this disk
  638.         exchange several times. When the process is complete, put the GRASP
  639.         disk away in a safe place and use the backup copy for your work.
  640.  
  641.  
  642.  
  643.  
  644.  
  645.  
  646.  
  647.  
  648.  
  649.  
  650.  
  651.  
  652.  
  653.  
  654.  
  655.  
  656.  
  657.  
  658.  
  659.  
  660.  
  661.  
  662.                    GRASP - Graphical System for Presentation
  663.                                    Page:  7
  664.  
  665.  
  666.  
  667.  
  668.  
  669.  
  670.                                  Installing GRASP
  671.  
  672.  
  673.         Simple Set-Up
  674.         -------------
  675.  
  676.         To  develop  demos  under  the  grasp  system, you need to have the
  677.         following GRASP files and programs accessible:
  678.  
  679.         GRASP.EXE
  680.         CM1.HLP
  681.         CM2.HLP
  682.         ED1.HLP
  683.         FD1.HLP
  684.         FD2.HLP
  685.         RP1.HLP
  686.  
  687.         as well as your pictures, clippings and fonts.
  688.  
  689.         With all of these files in  one subdirectory,  you will  be able to
  690.         create and  edit your  demo program and have access to the help. If
  691.         you do not need the help files, you may omit them. If you are going
  692.         to be  creating a  library version of your demo, you will also need
  693.         access to the librarian utility, GLIB.EXE. 
  694.  
  695.  
  696.  
  697.         Advanced Set-Up
  698.         ---------------
  699.  
  700.         The following is an example of a well set-up system on a hard disk,
  701.         including PCPAINT,  so that you can edit pictures and clippings and
  702.         create your demo with a minimum of effort.
  703.  
  704.         From the root directory, create a sub-directory called PAINTLIB and
  705.         put all  the PCPAINT  files in  it. (This is the recommended method
  706.         for installing PCPAINT). In addition, be  sure your  PATH statement
  707.         points to  PAINTLIB and  set up an environment variable to point to
  708.         PAINTLIB as well with the command:
  709.  
  710.         SET PAINTLIB=C:\PAINTLIB
  711.  
  712.         Also make a sub-directory off the root called GRASP. Copy the GRASP
  713.         disk contents  to the  sub-directory GRASP. Add the GRASP directory
  714.         to your PATH command. Then create a DEMO  directory, change  to it,
  715.         and run  GRASP by  typing GRASP at the command prompt. When you are
  716.         in the GRASP editor, you can  run PCPAINT  by pressing  ALT-F10 and
  717.         your previous  PATH and  SET statements will help DOS know where to
  718.         find it. The following diagram is an example:
  719.  
  720.  
  721.  
  722.  
  723.                    GRASP - Graphical System for Presentation
  724.                                    Page:  8
  725.  
  726.  
  727.  
  728.  
  729.  
  730.  
  731.                             GRASP Installation Diagram
  732.  
  733.  
  734.         This diagram  shows the  proper structure  for your sub-directories
  735.         for GRASP  to perform  in the  above stated  manner. This  is not a
  736.         requirement, just an example.
  737.                                        
  738.                                    ___________
  739.                                   |           |
  740.                                   |  C:\Root  |
  741.                                   |___________|
  742.                 ________________________|________________________ . . . .
  743.          ______|_______    ______|______    __________|__________    
  744.         |              |  |             |  |                     |
  745.         |   PAINTLIB   |  |    GRASP    |  |    DOS or OTHER     |
  746.         |______________|  |_____________|  |_____________________|   
  747.             :                  :      |          : 
  748.         PCPAINT.EXE        GRASP.EXE  |      DOS files
  749.         PxPAINT.OVR        ED1.HLP    |      Various batch files 
  750.         CAP.COM            CM1.HLP    |
  751.                            CM2.HLP    | 
  752.                            CM3.HLP    |
  753.                            FD1.HLP    |
  754.                            FD2.HLP    |
  755.                            RP1.HLP    |
  756.                                       |
  757.                            ___________|_ 
  758.                           |             | 
  759.                           |    Demos    |
  760.                           |_____________|
  761.  
  762.         Then these statements would be in your AUTOEXEC.BAT file:
  763.  
  764.         SET PAINTLIB=C:\PAINTLIB
  765.         PATH C:\PAINTLIB;C:\GRASP;C:\whateverelseyouwant...
  766.  
  767.         With this  set-up, you  can be  in any  directory and  run GRASP by
  768.         typing GRASP and PCPAINT by typing PCPAINT. You have full access to
  769.         all help files and the  PCPAINT  system.  The  auto-run  feature in
  770.         GRASP (ALT-F10)  allows you to run PCPAINT while in GRASP. It looks
  771.         for PCPAINT in the \PAINTLIB directory.  The  GRASP help  files are
  772.         only accessible if they are in one of three places:
  773.  
  774.         1) In the current directory
  775.         2) In the directory pointed to by the environment string 'PAINTLIB'
  776.         3) In a sub-directory off the root called 'GRASP'
  777.  
  778.         GRASP performs  a search  for the help files in this order. If they
  779.         are not found, a message  will  appear  when  you  first  run grasp
  780.         telling you so. You may run GRASP without access to the help files,
  781.         but you will get a beep if you try to access them.
  782.  
  783.  
  784.                    GRASP - Graphical System for Presentation
  785.                                    Page:  9
  786.  
  787.  
  788.  
  789.  
  790.  
  791.  
  792.                                 How do I use GRASP?
  793.  
  794.  
  795.         To use GRASP you need to do 3 things.
  796.  
  797.  
  798.         1) Create the pictures and clippings you want  to use  with PCPAINT
  799.         PLUS, or capture them the the CAP utility.
  800.  
  801.         2) Use the built-in GRASP editor to create an GRASP 'program' which
  802.         is nothing more than a list of GRASP commands and some comments.
  803.  
  804.         3) Run your demonstration  by pressing  F10 from  the editor  or by
  805.         selecting EXECUTE FILE from the main GRASP menu.
  806.  
  807.  
  808.         It's that  simple. If you want to give your demo away, you must put
  809.         the .PIC, .CLP, .SET and .TXT  files into  a library  with the GLIB
  810.         utility, and distribute the library file with GRASPRT.EXE.
  811.  
  812.  
  813.  
  814.  
  815.  
  816.  
  817.  
  818.  
  819.  
  820.  
  821.  
  822.  
  823.  
  824.  
  825.  
  826.  
  827.  
  828.  
  829.  
  830.  
  831.  
  832.  
  833.  
  834.  
  835.  
  836.  
  837.  
  838.  
  839.  
  840.  
  841.  
  842.  
  843.  
  844.  
  845.                    GRASP - Graphical System for Presentation
  846.                                    Page:  10
  847.  
  848.  
  849.  
  850.  
  851.  
  852.  
  853.                                    Running GRASP
  854.  
  855.  
  856.         To run the GRASP, enter at the command prompt:
  857.  
  858.  
  859.         A:>GRASP
  860.  
  861.  
  862.         You will be presented with a screen that looks something like this:
  863.  
  864.  
  865.                                      G R A S P
  866.                          GRAphical System for Presentation
  867.                            Version 1.10c - August, 1986
  868.                   Copyright (C) 1986 - Microtex Industries, Inc.
  869.  
  870.                                     Edit File      
  871.                                     Execute File   
  872.                                     Load File      
  873.                                     Save File      
  874.                                     Drive/Path
  875.                                     Exit GRASP     
  876.  
  877.         Current File: TMPFILE
  878.         Current Path: C:\GRASP\
  879.  
  880.         To select  an option from this menu, use the up and down arrow keys
  881.         until the option you want to select is highlighted. Then just press
  882.         return  and  the  option  is  selected. Each of these options has a
  883.         special meaning to GRASP.
  884.  
  885.         Edit File: The Edit File option tells GRASP that you want to  go to
  886.         the editor and create or modify your GRASP program file.
  887.  
  888.         Execute File:  The Execute  File option  tells GRASP to execute the
  889.         currently loaded GRASP program file.
  890.  
  891.         Load File: The Load File option allows you to tell GRASP to load in
  892.         an existing  file, or  to create  a new one. Notice that just below
  893.         the menu there is an area  with the  current filename  listed. When
  894.         you  first  run  GRASP,  the  system  will  default to a file named
  895.         TMPFILE. This is the name that GRASP will use unless  you specify a
  896.         new one.  To specify  a new one, just type in the name you want. DO
  897.         NOT specify  the filename  extension. GRASP  will automatically use
  898.         the extension  .TXT for you. To create a new file, just perform the
  899.         load as though the  file you  want already  exists. GRASP  is smart
  900.         enough to  understand and  create a  new file for you. If a file is
  901.         already loaded, and changes have been  made, GRASP  will prompt you
  902.         for saving before allowing you to load another. This keeps you from
  903.         trashing your current file.
  904.  
  905.  
  906.                    GRASP - Graphical System for Presentation
  907.                                    Page:  11
  908.  
  909.  
  910.  
  911.  
  912.  
  913.  
  914.         Save File: The Save File option tells GRASP that you want to save
  915.         the current working GRASP program file. It works  much the  same as
  916.         the load  command. Just  specify the name you want to save the file
  917.         under and press return. The  system  will  default  to  the current
  918.         working name.
  919.  
  920.         Drive/Path: The  Drive/Path option allows you to change the current
  921.         logged drive and path. This  is  useful  if  you  want  to continue
  922.         working  in  GRASP  but  want  to  work  on  a  different demo in a
  923.         different directory.
  924.  
  925.         Quit GRASP: The Quit GRASP option tells the system that you want to
  926.         exit GRASP. If a file is loaded and has been changed since the last
  927.         save, GRASP will prompt you for saving before allowing you to quit.
  928.  
  929.         Be sure to save your file before quitting!
  930.  
  931.  
  932.         Of these options, the only one that requires  special consideration
  933.         is the  first one,  Edit File. Select that option and let's explore
  934.         the world of the GRASP editor...
  935.  
  936.  
  937.  
  938.  
  939.  
  940.  
  941.  
  942.  
  943.  
  944.  
  945.  
  946.  
  947.  
  948.  
  949.  
  950.  
  951.  
  952.  
  953.  
  954.  
  955.  
  956.  
  957.  
  958.  
  959.  
  960.  
  961.  
  962.  
  963.  
  964.  
  965.  
  966.  
  967.                    GRASP - Graphical System for Presentation
  968.                                    Page:  12
  969.  
  970.  
  971.  
  972.  
  973.  
  974.  
  975.  
  976.                                  The Grasp Editor
  977.  
  978.  
  979.         If you have selected the Edit File option  from the  main menu, you
  980.         will now be in the GRASP editor. The screen should have a blue line
  981.         across the top that looks like the following:
  982.  
  983.  
  984.         TMPFILE         COL:1     LINE:1     POS:0     LEN:0      INSERT ON
  985.  
  986.         These are  just information  items about  the current  file you are
  987.         working on  and the mode you are operating in. Starting at the left
  988.         is the name of the current  file, which  defaults to  TMPFILE. Next
  989.         comes  the  current  cursor  column number, the current cursor line
  990.         number, the current cursor's  character  position  relative  to the
  991.         entire  file,  and  the  total  number of characters in the current
  992.         file. At the far right  is  the  status  of  the  INS  key  on your
  993.         keyboard. If  INSERT mode  is ON,  then characters you type will be
  994.         inserted before the character just to the right  of the  cursor. If
  995.         INSERT mode is OFF, then characters to the right of the cursor will
  996.         be overwritten. This second  mode, INSERT  OFF, is  commonly called
  997.         OVERSTRIKE mode.  This information is just there for reference, and
  998.         with the exception of  the INSERT  mode signal,  you probably won't
  999.         need to refer to it too often.
  1000.  
  1001.         The first  three function keys are the most important keys to learn
  1002.         in  the  GRASP  editor.  GRASP  provides  'Quick  Help'  for  three
  1003.         different areas and is accessable by pressing F1, F2 or F3. 
  1004.  
  1005.         NOTE: If  you press  one of these function keys and hear a low tone
  1006.         from your  computer  and  no  help  appears,  it  means  that GRASP
  1007.         couldn't find  the .HLP  files that were on your distribution disk.
  1008.         If you want to use the help. the .HLP files must be  on the current
  1009.         drive and directory, in a directory called 'GRASP' directly off the
  1010.         root directory,  or in  a directory  pointed to  by the environment
  1011.         string 'PAINTLIB'. See INSTALLING GRASP for more details.
  1012.  
  1013.         F1 -  Provides help in using the GRASP Editor. This includes a list
  1014.         of the most commonly used editing  keys and  a description  of what
  1015.         each function key is used for.
  1016.  
  1017.         F2  -  Provides  a  quick  summary  listing  of all available GRASP
  1018.         commands. This information  is  not  a  complete  reference  on the
  1019.         commands of  GRASP, but  rather a  command syntax reference so that
  1020.         you  can  insure  proper  useage  of  the  commands   and  a  brief
  1021.         description of what the command is used for. 
  1022.  
  1023.         F3 -  Provides a  summary listing  of the  25 GRASP fades and their
  1024.         respective  numbers.  Remember  that  all  fades  can  be  used for
  1025.         graphics  pictures,   text  pictures,  pictures  in  a  window  and
  1026.         clippings.
  1027.  
  1028.                    GRASP - Graphical System for Presentation
  1029.                                    Page:  13
  1030.  
  1031.  
  1032.  
  1033.  
  1034.  
  1035.  
  1036.  
  1037.         If this is your first time running GRASP  and you  are too  lazy or
  1038.         too  bored  to  read  the  entire  manual,  you  should find enough
  1039.         information in these help keys to get you started.
  1040.  
  1041.         If you want to learn a little more about the editor, here is a full
  1042.         description of all the keys available in the GRASP editor.
  1043.  
  1044.         F1  - Quick help with the editor.
  1045.         F2  - Quick help with the commands.
  1046.         F3  - Quick help with the fades and video modes.
  1047.         F4  - Start/End highlighting a block.
  1048.         F5  - Copy a highlighted block.
  1049.         F6  - Move a highlighted block.
  1050.         F7  - Read a block in from disk.
  1051.         F8  - Write a highlighted block to disk.
  1052.         F9  - Save current file and run from current line.
  1053.         F10 - Save current file and run from the top.
  1054.  
  1055.         ALT/F1   - Quick exit to DOS. Typing EXIT at the DOS propmt returns
  1056.                    you to the GRASP editor.
  1057.  
  1058.         ALT/F10  - Run PCPAINT from within  the  GRASP  editor. PCPAINT.EXE
  1059.                    and  its  overlays  must  be  in  a  subdirectory called
  1060.                    PAINTLIB off the root directory on the current drive.
  1061.  
  1062.         CTRL-K-X or
  1063.         ESC      - Quit the editor. Do not save  file. Leave  flag set that
  1064.                    indicates changes if they have been made. 
  1065.  
  1066.         CTRL-K-Q - Quit  the  editor.  Do  not  save  file.  Reset  flag to
  1067.                    indicate no changes have been made.
  1068.  
  1069.         CTRL-K-D or
  1070.         ALT/X    - Quit the editor, save file if changes have been made.
  1071.  
  1072.         CTRL-K-S or
  1073.         ALT/S or
  1074.         ALT/W    - Save the current file and continue editing.
  1075.  
  1076.         ALT/L or
  1077.         ALT/R    - Reload   the   current   file   and   continue  editing,
  1078.                    overwriting any changes made.
  1079.  
  1080.         CTRL-Y or
  1081.         ALT/D    - Delete current line.
  1082.  
  1083.         CTRL-N   - Insert  a  carriage  return  and leave cursor at current
  1084.                    line.
  1085.  
  1086.         CTRL-K-B - Mark block beginnng. Same as the first time you hit F4.
  1087.  
  1088.  
  1089.                    GRASP - Graphical System for Presentation
  1090.                                    Page:  14
  1091.  
  1092.  
  1093.  
  1094.  
  1095.  
  1096.  
  1097.         CTRL-K-K - Mark block end. Same as the second time you hit F4.
  1098.  
  1099.         CTRL-Q-B - Go to block beginning.
  1100.  
  1101.         CTRL-Q-K - Go to block end.
  1102.  
  1103.         CTRL-K-C - Copy a block. Same as F5.
  1104.  
  1105.         CTRL-K-V - Move a block. Same as F6.
  1106.  
  1107.         CTRL-K-R - Read block at cursor position. Same as F7.
  1108.  
  1109.         CTRL-K-W - Write block. Same as F8.
  1110.  
  1111.         CTRL-K-Y - Delete highlighted block. 
  1112.  
  1113.         CTRL-HOME or
  1114.         CTRL-Q-R - Go to top of file.
  1115.  
  1116.         CTRL-END or
  1117.         CTRL-Q-C - Go to end of file.
  1118.  
  1119.         CTRL-RIGHT ARROW or
  1120.         CTRL-F   - Skip word right.
  1121.  
  1122.         CTRL-LEFT ARROW or
  1123.         CTRL-A   - Skip word left.
  1124.  
  1125.         CTRL-Q-S or
  1126.         HOME     - Go to beginning of line.
  1127.  
  1128.         CTRL-Q-D or
  1129.         END      - Go to end of line.
  1130.  
  1131.         INS      - Turns insert mode on and off.
  1132.  
  1133.         DEL      - Deletes character under cursor and adjusts text.
  1134.  
  1135.         ARROW KEYS / PGUP /  PGDN  and  Wordstar(tm)  'Diamond' equivalents
  1136.         move cursor around document.
  1137.  
  1138.         Now that  you know  how to use the editor, let's see exactly how to
  1139.         make a demo...
  1140.  
  1141.  
  1142.  
  1143.  
  1144.  
  1145.  
  1146.  
  1147.  
  1148.  
  1149.  
  1150.                    GRASP - Graphical System for Presentation
  1151.                                    Page:  15
  1152.  
  1153.  
  1154.  
  1155.  
  1156.  
  1157.  
  1158.                                Simple GRASP Tutorial
  1159.  
  1160.         Loading and displaying a picture:
  1161.  
  1162.         It is important to  understand  that  GRASP  is  very  much  a LINE
  1163.         oriented  programming  pseudo-language.  It  is called this because
  1164.         inter-line dependencies have been kept  to  a  minimum.  In simpler
  1165.         terms, GRASP  interprets one line at a time, executes it, then goes
  1166.         and gets the next  line.  Except  for  a  few  special  cases, what
  1167.         happens on each line is relatively independent of the previous line
  1168.         or the next line. This is important because if you understand this,
  1169.         then  creating  a  GRASP  program  will  be easier to understand in
  1170.         concept.
  1171.  
  1172.         Each line can start with only one of three things:
  1173.  
  1174.         1) A GRASP command. (PRESS F2 to see all the GRASP commands)
  1175.  
  1176.         2) A semicolon - ';'. This indicates the beginning of a comment.
  1177.  
  1178.         3) A label. This can be any continuous  string of  ASCII characters
  1179.         with the exception of space, and must be followed by a colon - ':'.
  1180.  
  1181.         This keeps  the GRASP  interpreter's job  simple. It  either sees a
  1182.         command,  and  immediately  looks  for  possible  parameters,  or a
  1183.         semicolon, in  which case  it ignores  the rest  of that line, or a
  1184.         label, which it puts into a list so it can find it later if needed.
  1185.         Any  variation  from  these  three  options  will  result  in GRASP
  1186.         thinking that  what you  typed was  a GRASP command which it cannot
  1187.         understand, and results in an 'INVALID COMMAND IN LINE XXX' message
  1188.         when you try to execute the program.
  1189.  
  1190.         Usually, you  will want  to start you GRASP program with a comment,
  1191.         like a title of your program or your name, etc. Type:
  1192.  
  1193.         ; DEMO Program for GRASP
  1194.  
  1195.         and press return. You now have written a 1-line GRASP program. 
  1196.  
  1197.         Exciting huh? I'll bet you can't wait for more.
  1198.  
  1199.         The very first command  in every  GRASP program  should be  a VIDEO
  1200.         command which  tells GRASP which video mode you want to use. If you
  1201.         select a video mode that is not available  on your  computer, GRASP
  1202.         will try  to understand  and tell you so. If you get wierd results,
  1203.         or the screen seems  to  go  crazy,  don't  worry,  just  check the
  1204.         reference section  of this  manual to be sure you are using a valid
  1205.         video mode. For this  tutorial, we  will assume  that your computer
  1206.         has an  IBM Color  Graphics Adapter  or compatible, and we will use
  1207.         the standard 4 color 320x200 mode, which GRASP understands as video
  1208.         mode A.  Type the  following (exactly  as spelled below, with upper
  1209.         case):
  1210.  
  1211.                    GRASP - Graphical System for Presentation
  1212.                                    Page:  16
  1213.  
  1214.  
  1215.  
  1216.  
  1217.  
  1218.  
  1219.  
  1220.         ; DEMO Program for GRASP
  1221.         ;
  1222.         video Q
  1223.  
  1224.         Now press F10 to execute the program. (By the way, all this does is
  1225.         set the  video mode  and come  back to the editor. Not too exciting
  1226.         yet, but we're getting there...)
  1227.  
  1228.         You should get a message that says
  1229.  
  1230.                            Illegal argument(s) at line 3
  1231.                                  File TMPFILE.TXT
  1232.                              Press any Key to Continue
  1233.  
  1234.         Any time you see the message, it means that the command you entered
  1235.         was correct, but one of the arguments you entered was incorrect.
  1236.         Press a  key and  you will  be returned  back to the editor, to the
  1237.         line where  the error  occured. The  problem here  is that  Q is an
  1238.         invalid video  mode. Change it to A (which stands for CGA 320x200 4
  1239.         color mode) and press F10 again. Your screen  should blink  and the
  1240.         you will be put back in the editor.  
  1241.  
  1242.         Now we have named the program and set up a video mode, so it's time
  1243.         to try out some graphics commands.  On the  distribution disk  is a
  1244.         picture  named  GRASP.PIC.  This  is  a  4  color  picture from the
  1245.         CGADEMO.GL file. Let's load it into  GRASP and  display it  using a
  1246.         variety of fades.
  1247.  
  1248.         ; DEMO Program for GRASP
  1249.         ;
  1250.         video A
  1251.         ;
  1252.         pload grasp,1                    ; load picture into buffer #1
  1253.         pfade 0,1,0,0                    ; fade it to the screen using fade
  1254.                                          ;  #0
  1255.         waitkey                          ; wait for a keypress before      
  1256.                                          ;  returning to the editor.
  1257.  
  1258.         now, press  F10 and you should see the GRASP.PIC picture loaded and
  1259.         displayed. 
  1260.  
  1261.         Change the first parameter  of  the  pfade  command  to  any number
  1262.         between 0  and 25 and watch all the different special effects. Then
  1263.         to slow things down, try a number like 50 for  the third parameter,
  1264.         which is  the speed  of the  fade. Speed seems to have no effect on
  1265.         some fades, while on others, it makes a lot of  difference. This is
  1266.         because  of  the  nature  of  each individual fade. To optimize the
  1267.         performance of GRASP, it was decided that speed would be a relative
  1268.         number, that  is, relative  to the actual fade. This way, each fade
  1269.         may be accurately controlled from its fastest speed to its slowest.
  1270.  
  1271.  
  1272.                    GRASP - Graphical System for Presentation
  1273.                                    Page:  17
  1274.  
  1275.  
  1276.  
  1277.  
  1278.  
  1279.  
  1280.         Let's do  one more  command, the WINDOW command. Window means don't
  1281.         allow any part of the  picture  that  lies  outside  of  a specific
  1282.         rectangle to be faded to the screen. Add the window command to your
  1283.         demo program as follows:
  1284.  
  1285.         ; DEMO Program for GRASP
  1286.         ;
  1287.         video A
  1288.         ;
  1289.         pload grasp,1                    ; load picture into buffer #1
  1290.         window 0,0,100,100               ; set fade clip window
  1291.         pfade 0,1,0,0                    ; fade it to the screen using fade
  1292.                                          ;  #0
  1293.         waitkey                          ; wait for a keypress before
  1294.                                          ;  returning to the editor.
  1295.  
  1296.         now press  F10 and  watch the  difference. You should see that only
  1297.         the lower left part of your picture was  actually dissolved  to the
  1298.         screen. Change  the coordinates of the window command and watch the
  1299.         results.
  1300.  
  1301.         One other  note:  The  window  command  can  only  operate  on byte
  1302.         boundaries. For  most video modes, this means every 8 pixels in the
  1303.         x  direction.  You  don't  have  to   worry  because   WINDOW  will
  1304.         automatically adjust itself to a byte boundary.
  1305.           
  1306.         This  concludes  this  lesson.  Other  commands  in GRASP work in a
  1307.         similar fashion. Experiment with them. Just remember to  keep track
  1308.         of your  video modes  and buffers.  You may also want to take apart
  1309.         the demo program, CGADEMO.GL using the GLIB.EXE utility and look at
  1310.         the code for more examples.
  1311.  
  1312.  
  1313.  
  1314.  
  1315.  
  1316.  
  1317.  
  1318.  
  1319.  
  1320.  
  1321.  
  1322.  
  1323.  
  1324.  
  1325.  
  1326.  
  1327.  
  1328.  
  1329.  
  1330.  
  1331.  
  1332.  
  1333.                    GRASP - Graphical System for Presentation
  1334.                                    Page:  18
  1335.  
  1336.  
  1337.  
  1338.  
  1339.  
  1340.  
  1341.                     Running the library file version - GRASPRT
  1342.  
  1343.  
  1344.         The Library file, or runtime version of the program is identical to
  1345.         the  text  file  version  except  that  the  interpreter  gets  its
  1346.         information from  a library  file instead  of the  current disk and
  1347.         directory. The GLIB utility will put all of  your .PIC,  .CLP, .SET
  1348.         and .TXT  files into  a library  with the extension GL. To run your
  1349.         demo execute the command:
  1350.  
  1351.         GRASPRT <libfile> <textfile>
  1352.  
  1353.         If the textfile  is  omitted  from  the  command  line,  GRASP will
  1354.         execute the first text file it finds in the library.
  1355.  
  1356.         To run the demo that comes with GRASP, type:
  1357.  
  1358.         GRASPRT CGADEMO
  1359.  
  1360.  
  1361.  
  1362.  
  1363.  
  1364.  
  1365.  
  1366.  
  1367.  
  1368.  
  1369.  
  1370.  
  1371.  
  1372.  
  1373.  
  1374.  
  1375.  
  1376.  
  1377.  
  1378.  
  1379.  
  1380.  
  1381.  
  1382.  
  1383.  
  1384.  
  1385.  
  1386.  
  1387.  
  1388.  
  1389.  
  1390.  
  1391.  
  1392.  
  1393.  
  1394.                    GRASP - Graphical System for Presentation
  1395.                                    Page:  19
  1396.  
  1397.  
  1398.  
  1399.  
  1400.  
  1401.  
  1402.                      Using the GRASP Graphics Librarian - GLIB
  1403.  
  1404.         The Graphics LIBrarian, GLIB.EXE, is used in the following manner:
  1405.  
  1406.         GLIB [-dstuea] libname [files...]  
  1407.  
  1408.         where the following commands are supported:
  1409.  
  1410.          -d   delete file from library
  1411.          -s   extended file list
  1412.          -t   quick file list
  1413.          -u   update (add) file to library
  1414.          -e   extract file from library
  1415.          -a   extract all files from library
  1416.  
  1417.         For example,  if you  wanted to  put all  of the  .PIC files in the
  1418.         current directory into a library file named MYFILE, you would type:
  1419.  
  1420.         GLIB -u MYFILE *.PIC
  1421.  
  1422.         Or if you wanted to extract GRASP.PIC from the library CGADEMO, you
  1423.         would type:
  1424.  
  1425.         GLIB -e CGADEMO GRASP.PIC
  1426.  
  1427.         Be   sure that  all files  needed for  your demo are in the library
  1428.         file before you  try  to  run  it.  Otherwise,  you  may  get error
  1429.         messages.
  1430.  
  1431.         NOTE:
  1432.         You  cannot  use  wild  cards  for  extracting  or deleting in this
  1433.         version (1.0) of GLIB. However, you may use  wild cards  for adding
  1434.         to or updating the library.
  1435.  
  1436.         More Examples:
  1437.  
  1438.         GLIB -d DEMO FRED.TXT
  1439.  
  1440.         will delete the file 'fred.txt' from library file DEMO.GL
  1441.  
  1442.         GLIB -e DEMO LOGO.CLP
  1443.  
  1444.         will extract the clipping 'logo.clp' from library file DEMO.GL
  1445.  
  1446.         GLIB -u DEMO MTX.CLP
  1447.  
  1448.         will add/replace the picture 'mtx.pic' to library file DEMO.GL
  1449.  
  1450.  
  1451.  
  1452.  
  1453.  
  1454.  
  1455.                    GRASP - Graphical System for Presentation
  1456.                                    Page:  20
  1457.  
  1458.  
  1459.  
  1460.  
  1461.  
  1462.  
  1463.                         This page intentionally left blank
  1464.  
  1465.  
  1466.  
  1467.  
  1468.  
  1469.  
  1470.  
  1471.  
  1472.  
  1473.  
  1474.  
  1475.  
  1476.  
  1477.  
  1478.  
  1479.  
  1480.  
  1481.  
  1482.  
  1483.  
  1484.  
  1485.  
  1486.  
  1487.  
  1488.  
  1489.  
  1490.  
  1491.  
  1492.  
  1493.  
  1494.  
  1495.  
  1496.  
  1497.  
  1498.  
  1499.  
  1500.  
  1501.  
  1502.  
  1503.  
  1504.  
  1505.  
  1506.  
  1507.  
  1508.  
  1509.  
  1510.  
  1511.  
  1512.  
  1513.  
  1514.  
  1515.  
  1516.                    GRASP - Graphical System for Presentation
  1517.                                    Page:  21
  1518.  
  1519.  
  1520.  
  1521.  
  1522.  
  1523.  
  1524.  
  1525.                          The commands of GRASP - Detailed
  1526.  
  1527.  
  1528.  
  1529.  
  1530.  
  1531.  
  1532.  
  1533.  
  1534.  
  1535.  
  1536.  
  1537.  
  1538.  
  1539.  
  1540.  
  1541.  
  1542.  
  1543.  
  1544.  
  1545.  
  1546.  
  1547.  
  1548.  
  1549.  
  1550.  
  1551.  
  1552.  
  1553.  
  1554.  
  1555.  
  1556.  
  1557.  
  1558.  
  1559.  
  1560.  
  1561.  
  1562.  
  1563.  
  1564.  
  1565.  
  1566.  
  1567.  
  1568.  
  1569.  
  1570.  
  1571.  
  1572.  
  1573.  
  1574.  
  1575.  
  1576.  
  1577.                    GRASP - Graphical System for Presentation
  1578.                                    Page:  22
  1579.  
  1580.  
  1581.  
  1582.  
  1583.  
  1584.  
  1585.                         This page intentionally left blank
  1586.  
  1587.  
  1588.  
  1589.  
  1590.  
  1591.  
  1592.  
  1593.  
  1594.  
  1595.  
  1596.  
  1597.  
  1598.  
  1599.  
  1600.  
  1601.  
  1602.  
  1603.  
  1604.  
  1605.  
  1606.  
  1607.  
  1608.  
  1609.  
  1610.  
  1611.  
  1612.  
  1613.  
  1614.  
  1615.  
  1616.  
  1617.  
  1618.  
  1619.  
  1620.  
  1621.  
  1622.  
  1623.  
  1624.  
  1625.  
  1626.  
  1627.  
  1628.  
  1629.  
  1630.  
  1631.  
  1632.  
  1633.  
  1634.  
  1635.  
  1636.  
  1637.  
  1638.                    GRASP - Graphical System for Presentation
  1639.                                    Page:  23
  1640.  
  1641.  
  1642.  
  1643.  
  1644.  
  1645.  
  1646.         BOX                                                            BOX
  1647.  
  1648.  
  1649.         Summary:
  1650.         -------
  1651.  
  1652.         BOX allows  you to  draw a box on the screen in the current drawing
  1653.         color.
  1654.  
  1655.  
  1656.         Syntax:
  1657.         ------
  1658.  
  1659.         BOX startx, starty, endx, endy, <width>
  1660.  
  1661.         where 'startx' and 'starty' is the point of  one corner  of the box
  1662.         and 'endx'  and endy'  is the  point of  the opposite corner of the
  1663.         box. Width is the number of  pixels wide  you want  the box  to be.
  1664.         Width is drawn 'inward' from the original box. 
  1665.  
  1666.  
  1667.         Example:
  1668.         -------
  1669.  
  1670.         BOX 0,0,100,100
  1671.  
  1672.         will  draw  a  box  in  the  current drawing color from x=0, y=0 to
  1673.         x=100, y=100.
  1674.  
  1675.  
  1676.         Comments:
  1677.         --------
  1678.  
  1679.         Transparent mode does not affect this command. Default  width is 1.
  1680.         BOX is not available in text modes.
  1681.  
  1682.  
  1683.  
  1684.  
  1685.  
  1686.  
  1687.  
  1688.  
  1689.  
  1690.  
  1691.  
  1692.  
  1693.  
  1694.  
  1695.  
  1696.  
  1697.  
  1698.  
  1699.                    GRASP - Graphical System for Presentation
  1700.                                    Page:  24
  1701.  
  1702.  
  1703.  
  1704.  
  1705.  
  1706.  
  1707.         CFADE                                                        CFADE
  1708.  
  1709.  
  1710.         Summary:
  1711.         -------
  1712.  
  1713.         CFADE allows  you to dissolve or fade a clipping to the screen. You
  1714.         may specify one of several dissolves, the speed  for that dissolve,
  1715.         and a  delay after  the dissolve. This command is similar to PFADE,
  1716.         but applies to clippings. The same 25 fades that apply  to pictures
  1717.         also apply to clippings.
  1718.  
  1719.  
  1720.         Syntax:
  1721.         ------
  1722.  
  1723.         CFADE fade number, x, y, <buffer number>, <speed>, <delay>
  1724.  
  1725.         where 'fade  number' is  the number  of the  fade you  want to use,
  1726.         'buffer number' is the  clipping buffer  number where  the clipping
  1727.         you want  to fade has been loaded, 'x' and 'y' are the location for
  1728.         the clipping  to be  faded, 'speed'  is the  speed of  the fade and
  1729.         'delay' is  the time  to wait  after the delay. Speed can be in the
  1730.         range 0-10000. Check Appendix B for a list of fades.
  1731.  
  1732.  
  1733.         Example:
  1734.         -------
  1735.  
  1736.         CFADE 2,20,40,5,500,1000
  1737.  
  1738.         will fade the clipping in buffer 5 using  fade 2  at location x=24,
  1739.         y=40 at  speed 500,  and then  wait 10 seconds. The delay works the
  1740.         same as using the WAITKEY command. 
  1741.  
  1742.  
  1743.         Comments:
  1744.         --------
  1745.  
  1746.         Note: CFADE only fades byte-width clippings and puts them up at the
  1747.         nearest  byte  boundary  to  the  x and y specified in the command.
  1748.         Deviations may cause unpredictable results. Use the utility WHATCLP
  1749.         to  obtain  the  needed  information  about your clippings. If your
  1750.         clipping  is  not  byte-width,  it  will  fill  the  right  edge to
  1751.         byte-width with  white (highest  color available). Transparent mode
  1752.         does NOT apply to CFADE. 
  1753.  
  1754.         Default values for optional parameters:
  1755.  
  1756.         buffer number: 1
  1757.         speed:         0
  1758.         delay:         0
  1759.  
  1760.                    GRASP - Graphical System for Presentation
  1761.                                    Page:  25
  1762.  
  1763.  
  1764.  
  1765.  
  1766.  
  1767.  
  1768.         CFREE                                                        CFREE
  1769.  
  1770.  
  1771.         Summary:
  1772.         -------
  1773.  
  1774.         CFREE is used to free-up a clipping buffer. Sometimes, you  may run
  1775.         out of  memory and  need to  clear up some buffers you have full of
  1776.         clippings you have already used.
  1777.  
  1778.  
  1779.         Syntax:
  1780.         ------
  1781.  
  1782.         CFREE buf1, <buf2>, <buf3>...
  1783.  
  1784.         where 'buf1' and other buffers are buffers you want to free-up.
  1785.  
  1786.  
  1787.         Example:
  1788.         -------
  1789.  
  1790.         CFREE 1,4,12
  1791.  
  1792.         will free-up clipping buffers 1, 4 and 12.
  1793.  
  1794.         CFREE 1,-,16
  1795.  
  1796.         will free-up buffers 1 through 16. You MUST use commas or spaces to
  1797.         separate these parameters.
  1798.  
  1799.  
  1800.         Comments:
  1801.         --------
  1802.  
  1803.         This  is  especially  useful  in  EGA  16 color mode where space is
  1804.         critical.
  1805.  
  1806.  
  1807.  
  1808.  
  1809.  
  1810.  
  1811.  
  1812.  
  1813.  
  1814.  
  1815.  
  1816.  
  1817.  
  1818.  
  1819.  
  1820.  
  1821.                    GRASP - Graphical System for Presentation
  1822.                                    Page:  26
  1823.  
  1824.  
  1825.  
  1826.  
  1827.  
  1828.  
  1829.         CHGCOLOR                                                  CHGCOLOR
  1830.  
  1831.  
  1832.         Summary:
  1833.         -------
  1834.  
  1835.         Chgcolor is used to set the color palette  registers in  IBM EGA 16
  1836.         color mode.  On the  EGA, there  are 16  possible colors, called an
  1837.         'index', and each of  these color  indices may  be one  of 64 color
  1838.         'values'.
  1839.  
  1840.  
  1841.         Syntax:
  1842.         ------
  1843.  
  1844.         CHGCOLOR color index, color value,...
  1845.  
  1846.         where 'color  index' refers  to the color number you want to change
  1847.         in the range 0-15 and 'color value' lies in the range 0-63.
  1848.  
  1849.  
  1850.         Example:
  1851.         -------
  1852.  
  1853.         CHGCOLOR 3,32
  1854.  
  1855.         will change color index 3 to color value 32.
  1856.  
  1857.  
  1858.         Comments:
  1859.         --------
  1860.  
  1861.         Remember, this only works in EGA 16 color modes.
  1862.  
  1863.  
  1864.  
  1865.  
  1866.  
  1867.  
  1868.  
  1869.  
  1870.  
  1871.  
  1872.  
  1873.  
  1874.  
  1875.  
  1876.  
  1877.  
  1878.  
  1879.  
  1880.  
  1881.  
  1882.                    GRASP - Graphical System for Presentation
  1883.                                    Page:  27
  1884.  
  1885.  
  1886.  
  1887.  
  1888.  
  1889.  
  1890.         CIRCLE                                                      CIRCLE
  1891.  
  1892.  
  1893.         Summary:
  1894.         -------
  1895.  
  1896.         CIRCLE allows you to draw a circle or ellipse on the screen  in the
  1897.         current drawing  color. The  color parameters  must be specified in
  1898.         pairs, as in the example.
  1899.  
  1900.  
  1901.         Syntax:
  1902.         ------
  1903.  
  1904.         CIRCLE centerx, centery, xradius, <yradius>
  1905.  
  1906.         where 'centerx' and 'centery' is the center point of the  circle or
  1907.         ellipse, xradius' is the radius in the x-direction and 'yradius' is
  1908.         the radius in the y direction.
  1909.  
  1910.  
  1911.         Example:
  1912.         -------
  1913.  
  1914.         CIRCLE 100,100,100,20
  1915.  
  1916.         will draw a circle centered at x=100, y=100 with x radius=100 and y
  1917.         radius=20.
  1918.  
  1919.  
  1920.         Comments:
  1921.         --------
  1922.  
  1923.         Transparent mode does not affect this command. Failure to specify a
  1924.         yradius assumes yradius=xradius and a circle is produced. Note also
  1925.         that circle  here implies  xradius=yradius which,  depending on the
  1926.         aspect ratio of your current  video  mode,  may  not  be  a circle.
  1927.         CIRCLE is not available in text modes.
  1928.  
  1929.  
  1930.  
  1931.  
  1932.  
  1933.  
  1934.  
  1935.  
  1936.  
  1937.  
  1938.  
  1939.  
  1940.  
  1941.  
  1942.  
  1943.                    GRASP - Graphical System for Presentation
  1944.                                    Page:  28
  1945.  
  1946.  
  1947.  
  1948.  
  1949.  
  1950.  
  1951.         CLEARSCR                                                  CLEARSCR
  1952.  
  1953.  
  1954.         Summary:
  1955.         -------
  1956.  
  1957.         Clearscr is used to clear the screen to the current drawing color.
  1958.  
  1959.  
  1960.         Syntax:
  1961.         ------
  1962.  
  1963.         CLEARSCR
  1964.  
  1965.  
  1966.         Example:
  1967.         -------
  1968.  
  1969.         CLEARSCR
  1970.  
  1971.         will clear  the screen  to the current drawing color (the color set
  1972.         with the last COLOR command).
  1973.  
  1974.  
  1975.         Comments:
  1976.         --------
  1977.  
  1978.  
  1979.  
  1980.  
  1981.  
  1982.  
  1983.  
  1984.  
  1985.  
  1986.  
  1987.  
  1988.  
  1989.  
  1990.  
  1991.  
  1992.  
  1993.  
  1994.  
  1995.  
  1996.  
  1997.  
  1998.  
  1999.  
  2000.  
  2001.  
  2002.  
  2003.  
  2004.                    GRASP - Graphical System for Presentation
  2005.                                    Page:  29
  2006.  
  2007.  
  2008.  
  2009.  
  2010.  
  2011.  
  2012.         CLOAD                                                        CLOAD
  2013.  
  2014.  
  2015.         Summary:
  2016.         -------
  2017.  
  2018.         This command is used to load  a clipping  into a  buffer. There are
  2019.         128 buffers  available for  clippings in  GRASP. It is advised, for
  2020.         memory reasons, that  the  user  try  to  manage  using  as  few as
  2021.         possible. A  clipping must be loaded into a buffer before it can be
  2022.         dissolved or put up onto the screen.
  2023.  
  2024.  
  2025.         Syntax:
  2026.         ------
  2027.  
  2028.         CLOAD clipping, buffer number, <shiftparm>
  2029.  
  2030.         where 'clipping' is the name of the clipping you want  to load (the
  2031.         file name  extension is optional) and 'buffer number' is the number
  2032.         of the buffer you want to load in  to. Valid  buffer numbers  are 1
  2033.         through 128.  Buffer 0  is non-existent for clippings, and thus, no
  2034.         clipping may be loaded  into it.  'Shiftparm' indicates  whether or
  2035.         not to  create the  shifted copies  necessary to place clippings at
  2036.         non-byte boundaries. Default for shiftparm is 0 or YES. Placing a 1
  2037.         here will  cause GRASP  not to  create the  shifted copies and thus
  2038.         saving memory. This is useful if you know that you are going  to be
  2039.         using CFADE on this clipping and therefore couldn't use the shifted
  2040.         copies anyway.
  2041.  
  2042.  
  2043.         Example:
  2044.         -------
  2045.  
  2046.         CLOAD myclip,5
  2047.  
  2048.         will load the clipping myclip.clp into clipping buffer number 5.
  2049.  
  2050.  
  2051.         Comments:
  2052.         --------
  2053.  
  2054.         If you do not understand the concept of shifted copies,  it is best
  2055.         not to  fool around  with the shiftparm parameter. Note also that a
  2056.         file extension is not  necessary in  your GRASP  file. Drive letter
  2057.         and path may be specified.
  2058.  
  2059.  
  2060.  
  2061.  
  2062.  
  2063.  
  2064.  
  2065.                    GRASP - Graphical System for Presentation
  2066.                                    Page:  30
  2067.  
  2068.  
  2069.  
  2070.  
  2071.  
  2072.  
  2073.         COLOR                                                        COLOR
  2074.  
  2075.  
  2076.         Summary:
  2077.         -------
  2078.  
  2079.         COLOR allows  you to  choose a drawing color. Drawing color is used
  2080.         for drawing primitives  (such  as  line,  box,  circle,  or point),
  2081.         transparent mode  selection, text  strings and clearing the screen.
  2082.         Secondary color is used for background color in text mode or shadow
  2083.         color for font styles in graphics modes.
  2084.  
  2085.  
  2086.         Syntax:
  2087.         ------
  2088.  
  2089.         COLOR n1,<n2>
  2090.  
  2091.         where 'n1' is the drawing color and 'n2' is the secondary color.
  2092.  
  2093.  
  2094.         Example:
  2095.         -------
  2096.  
  2097.         COLOR 3,0
  2098.  
  2099.         will set  the current  drawing color  to color  3 and the secondary
  2100.         color to 0.
  2101.  
  2102.  
  2103.         Comments:
  2104.         --------
  2105.  
  2106.         Related commands are  LINE,  BOX,  CIRCLE,  POINT,  TRAN, CLEARSCR,
  2107.         PALETTE, MODE and PFADE. The secondary color is used for the bottom
  2108.         character in shadow text strings and the background  color for text
  2109.         screens. Secondary color defaults to color 0 if not specified.
  2110.  
  2111.  
  2112.  
  2113.  
  2114.  
  2115.  
  2116.  
  2117.  
  2118.  
  2119.  
  2120.  
  2121.  
  2122.  
  2123.  
  2124.  
  2125.  
  2126.                    GRASP - Graphical System for Presentation
  2127.                                    Page:  31
  2128.  
  2129.  
  2130.  
  2131.  
  2132.  
  2133.  
  2134.         EXEC                                                          EXEC
  2135.  
  2136.  
  2137.         Summary:
  2138.         -------
  2139.         This command allows you to execute another program from within your
  2140.         GRASP program. Useful for utility programs, or custom  programs you
  2141.         write that provide a function that GRASP does not.
  2142.  
  2143.  
  2144.         Syntax:
  2145.         ------
  2146.  
  2147.         EXEC program, <parameters>
  2148.  
  2149.         where 'program' is the name of the program you wish to execute. You
  2150.         MUST include path if  it is  in a  different path,  and all program
  2151.         names must include the extension. 'Parameters' are any command line
  2152.         parameters you would normally pass to the program.
  2153.  
  2154.  
  2155.         Example:
  2156.         -------
  2157.  
  2158.         EXEC \PAINTLIB\PCPAINT.EXE, /O
  2159.  
  2160.         will execute pcpaint from  the \paintlib  directory on  the current
  2161.         drive passing the /O parameter.
  2162.  
  2163.  
  2164.         Comments:
  2165.         --------
  2166.  
  2167.         You MUST include full path and file extension.
  2168.  
  2169.  
  2170.  
  2171.  
  2172.  
  2173.  
  2174.  
  2175.  
  2176.  
  2177.  
  2178.  
  2179.  
  2180.  
  2181.  
  2182.  
  2183.  
  2184.  
  2185.  
  2186.  
  2187.                    GRASP - Graphical System for Presentation
  2188.                                    Page:  32
  2189.  
  2190.  
  2191.  
  2192.  
  2193.  
  2194.  
  2195.         EXIT                                                          EXIT
  2196.  
  2197.  
  2198.         Summary:
  2199.         --------
  2200.  
  2201.         Exit will  cause the  currently running  GRASP program  to quit and
  2202.         return to DOS or the GRASP editor.
  2203.  
  2204.  
  2205.         Syntax:
  2206.         ------
  2207.  
  2208.         EXIT
  2209.  
  2210.  
  2211.         Example:
  2212.         -------
  2213.  
  2214.         EXIT
  2215.  
  2216.         will cause the currently running  GRASP  program  to  terminate and
  2217.         return to DOS or the GRASP editor.
  2218.  
  2219.  
  2220.         Comments:
  2221.         --------
  2222.  
  2223.         If you  are running  GRASPRT, EXIT  returns you  to DOS. If you are
  2224.         running GRASP, EXIT returns  you to  the editor  or the  main menu,
  2225.         depending on how you ran the program.
  2226.  
  2227.  
  2228.  
  2229.  
  2230.  
  2231.  
  2232.  
  2233.  
  2234.  
  2235.  
  2236.  
  2237.  
  2238.  
  2239.  
  2240.  
  2241.  
  2242.  
  2243.  
  2244.  
  2245.  
  2246.  
  2247.  
  2248.                    GRASP - Graphical System for Presentation
  2249.                                    Page:  33
  2250.  
  2251.  
  2252.  
  2253.  
  2254.  
  2255.  
  2256.         FFREE                                                        FFREE
  2257.  
  2258.  
  2259.         Summary:
  2260.         -------
  2261.  
  2262.         This command  will free  up the font buffer so that more memory may
  2263.         be available for pictures and clippings.
  2264.  
  2265.  
  2266.         Syntax:
  2267.         ------
  2268.  
  2269.         FFREE
  2270.  
  2271.  
  2272.         Example:
  2273.         -------
  2274.  
  2275.         FFREE
  2276.  
  2277.         will free up the font buffer.
  2278.  
  2279.  
  2280.         Comments:
  2281.         --------
  2282.  
  2283.  
  2284.  
  2285.  
  2286.  
  2287.  
  2288.  
  2289.  
  2290.  
  2291.  
  2292.  
  2293.  
  2294.  
  2295.  
  2296.  
  2297.  
  2298.  
  2299.  
  2300.  
  2301.  
  2302.  
  2303.  
  2304.  
  2305.  
  2306.  
  2307.  
  2308.  
  2309.                    GRASP - Graphical System for Presentation
  2310.                                    Page:  34
  2311.  
  2312.  
  2313.  
  2314.  
  2315.  
  2316.  
  2317.         FGAPS                                                        FGAPS
  2318.  
  2319.  
  2320.         Summary:
  2321.         -------
  2322.  
  2323.         This command allows you to set the gaps  between characters  in the
  2324.         text command and also the width of the space character.
  2325.  
  2326.  
  2327.         Syntax:
  2328.         ------
  2329.  
  2330.         FGAPS <char gap, space gap>
  2331.  
  2332.         where  'char gap  is  the  number  of pixels between characters and
  2333.         'space gap' is the number of pixels wide for the space character.
  2334.  
  2335.  
  2336.         Example:
  2337.         -------
  2338.  
  2339.         FGAPS 3,9
  2340.  
  2341.         will  set  the  inter-character  gap  to  3  pixels  and  the space
  2342.         character to a width of 9 pixels.
  2343.  
  2344.  
  2345.         Comments:
  2346.         --------
  2347.  
  2348.         Note that this has no effect on the TEXT command if you are in TEXT
  2349.         mode. FGAPS with no parameters resets the gaps to the  default gaps
  2350.         for the currently loaded font.
  2351.  
  2352.  
  2353.  
  2354.  
  2355.  
  2356.  
  2357.  
  2358.  
  2359.  
  2360.  
  2361.  
  2362.  
  2363.  
  2364.  
  2365.  
  2366.  
  2367.  
  2368.  
  2369.  
  2370.                    GRASP - Graphical System for Presentation
  2371.                                    Page:  35
  2372.  
  2373.  
  2374.  
  2375.  
  2376.  
  2377.  
  2378.         FLOAD                                                        FLOAD
  2379.  
  2380.  
  2381.         Summary:
  2382.         -------
  2383.  
  2384.         This command  is used  to load in a character set. The GRASP system
  2385.         only allows 1 character set in memory at a time.  After a character
  2386.         set  has  been  loaded,  TEXT  commands  (see command TEXT) will be
  2387.         performed using the currently loaded font. Applies only to graphics
  2388.         modes.
  2389.  
  2390.  
  2391.         Syntax:
  2392.         ------
  2393.  
  2394.         FLOAD fontname
  2395.  
  2396.         where 'fontname'  is the  name of  the FONTRIX(tm)  or PCPAINT font
  2397.         file you wish to load. File name extensions are optional.
  2398.  
  2399.  
  2400.         Example:
  2401.         -------
  2402.  
  2403.         FLOAD bocklin
  2404.  
  2405.         will load the FONTRIX(tm) font bocklin.set  into memory  for use by
  2406.         the TEXT command.
  2407.  
  2408.  
  2409.         Comments:
  2410.         --------
  2411.  
  2412.         When a font is loaded with FLOAD, the gaps are reset to the default
  2413.         gaps for that font. So  be  sure  to  reset  gaps  using  the FGAPS
  2414.         command if the default gaps aren't adequate. 
  2415.  
  2416.  
  2417.  
  2418.  
  2419.  
  2420.  
  2421.  
  2422.  
  2423.  
  2424.  
  2425.  
  2426.  
  2427.  
  2428.  
  2429.  
  2430.  
  2431.                    GRASP - Graphical System for Presentation
  2432.                                    Page:  36
  2433.  
  2434.  
  2435.  
  2436.  
  2437.  
  2438.  
  2439.         FLOAT                                                        FLOAT
  2440.  
  2441.  
  2442.         Summary:
  2443.         -------
  2444.  
  2445.         FLOAT  allows  you  to  animate  a  clipping or series of clippings
  2446.         between any two points on the screen with one command. It
  2447.         is similar to FLY except that it performs  an exchange  with screen
  2448.         data so that the background may be preserved. 
  2449.  
  2450.         Syntax:
  2451.         ------
  2452.  
  2453.         FLOAT startx,  starty, endx,  endy, increment, delay, clip1, clip2,
  2454.         ...clipn
  2455.  
  2456.         where 'startx' and 'starty' indicate the starting point, 'endx' and
  2457.         'endy'  indicate  the  ending  point,  'increment'  is the distance
  2458.         between each put along the line, 'delay' is  the wait  time between
  2459.         each put and 'clip1-clipn' is the list of clippings. 
  2460.  
  2461.  
  2462.         Example:
  2463.         -------
  2464.  
  2465.         FLOAT 0,0,200,200,2,10,1,2,3
  2466.  
  2467.         will 'FLOAT'  the clippings  1,2 and  3   in that order from 0,0 to
  2468.         200,200, skipping 2 pixels between each put, waiting a count  of 10
  2469.         between each  put. For  example, clip  1 will be put at 0,0, clip 2
  2470.         will be put at clip 2,2, clip 3 will be put a  4,4, clip  1 will be
  2471.         put at 6,6, clip2 will be put at 8,8, etc.
  2472.  
  2473.  
  2474.         Comments:
  2475.         --------
  2476.  
  2477.         This command  differs from FLY in that it preserves the background.
  2478.         Also note  that the  last operation  it performs  is the swap-back,
  2479.         which restores  screen data.  This means that if you want to have a
  2480.         clipping on the screen after the FLOAT command, you have  to follow
  2481.         the FLOAT  with a  PUTUP command.  Selective use of transparent can
  2482.         yield very interesting results.
  2483.  
  2484.  
  2485.  
  2486.  
  2487.  
  2488.  
  2489.  
  2490.  
  2491.  
  2492.                    GRASP - Graphical System for Presentation
  2493.                                    Page:  37
  2494.  
  2495.  
  2496.  
  2497.  
  2498.  
  2499.  
  2500.         FLY                                                            FLY
  2501.  
  2502.  
  2503.         Summary:
  2504.         -------
  2505.  
  2506.         FLY allows you to animate a clipping or series of clippings between
  2507.         any two points on the screen with one command.
  2508.  
  2509.  
  2510.         Syntax:
  2511.         ------
  2512.  
  2513.         FLY  startx,  starty,  endx,  endy, increment, delay, clip1, clip2,
  2514.         ...clipn
  2515.  
  2516.         where 'startx' and 'starty' indicate the starting point, 'endx' and
  2517.         'endy'  indicate  the  ending  point,  'increment'  is the distance
  2518.         between each put along the line, 'delay' is  the wait  time between
  2519.         each  put  and  'clip1-clipn'  is  the  list  of clippings. You may
  2520.         animate up to 10 clippings.
  2521.  
  2522.  
  2523.         Example:
  2524.         -------
  2525.  
  2526.         FLY 0,0,200,200,2,10,1,2,3
  2527.  
  2528.         will 'fly' the clippings 1,2 and 3    in  that  order  from  0,0 to
  2529.         200,200, skipping  2 pixels between each put, waiting a count of 10
  2530.         between each put. For example, clip 1 will  be put  at 0,0,  clip 2
  2531.         will be  put at  clip 2,2, clip 3 will be put a 4,4, clip 1 will be
  2532.         put at 6,6, clip2 will be put at 8,8, etc.
  2533.  
  2534.  
  2535.         Comments:
  2536.         --------
  2537.          
  2538.         Selective use of slightly larger than necessary clippings  (to wipe
  2539.         out  the    previous  put)  and  transparent  mode  can  yield very
  2540.         interesting results.
  2541.  
  2542.  
  2543.  
  2544.  
  2545.  
  2546.  
  2547.  
  2548.  
  2549.  
  2550.  
  2551.  
  2552.  
  2553.                    GRASP - Graphical System for Presentation
  2554.                                    Page:  38
  2555.  
  2556.  
  2557.  
  2558.  
  2559.  
  2560.  
  2561.         FSTYLE                                                       FSTYLE
  2562.  
  2563.  
  2564.         Summary:
  2565.         -------
  2566.  
  2567.         This command allows you to choose a style for the characters in the
  2568.         TEXT command. Styles are as follows:
  2569.  
  2570.         style #    style
  2571.         -------    -----
  2572.            0       Default, normal letters
  2573.            1       Bold up.
  2574.            2       Bold right.
  2575.            3       Shadow up right.
  2576.            4       Shadow up left.
  2577.            5       Shadow up right 2 pixels.
  2578.            6       Shadow up left 2 pixels.
  2579.  
  2580.  
  2581.         Syntax:
  2582.         ------
  2583.  
  2584.         FSTYLE fstyle
  2585.  
  2586.         where fstyle is the number of the desired style.
  2587.  
  2588.  
  2589.         Example:
  2590.         -------
  2591.  
  2592.         FSTYLE 4
  2593.  
  2594.         will set the text style to shadow up left.
  2595.  
  2596.  
  2597.         Comments:
  2598.         --------
  2599.         Use of the command with no parameters will default to style 0.
  2600.  
  2601.  
  2602.  
  2603.  
  2604.  
  2605.  
  2606.  
  2607.  
  2608.  
  2609.  
  2610.  
  2611.  
  2612.  
  2613.  
  2614.                    GRASP - Graphical System for Presentation
  2615.                                    Page:  39
  2616.  
  2617.  
  2618.  
  2619.  
  2620.  
  2621.  
  2622.         GOSUB                                                        GOSUB
  2623.  
  2624.  
  2625.         Summary:
  2626.         -------
  2627.  
  2628.         This command  allows the  transfer of control during execution of a
  2629.         GRASP program to a  sub-program defined  elsewhere in  the program.
  2630.         This is similar to a BASIC gosub command. The subprogram is defined
  2631.         by a label at the beginning, and a RETURN command at the  end. When
  2632.         the  RETURN  is  encountered,  control  is  returned  to  the  line
  2633.         following the line where the GOSUB ocurred.
  2634.  
  2635.  
  2636.         Syntax:
  2637.         ------
  2638.  
  2639.         GOSUB subroutine
  2640.  
  2641.         where 'subroutine' is a sub-program defined elsewhere in  the GRASP
  2642.         program.
  2643.  
  2644.  
  2645.         Example:
  2646.         -------
  2647.  
  2648.         GOSUB myprog
  2649.  
  2650.         will  transfer  control  to  the sub-program 'myprog'. Control will
  2651.         return when the statement RETURN in encountered in the sub-program.
  2652.  
  2653.  
  2654.         Comments:
  2655.         --------
  2656.  
  2657.         Also see command RETURN.
  2658.  
  2659.  
  2660.  
  2661.  
  2662.  
  2663.  
  2664.  
  2665.  
  2666.  
  2667.  
  2668.  
  2669.  
  2670.  
  2671.  
  2672.  
  2673.  
  2674.  
  2675.                    GRASP - Graphical System for Presentation
  2676.                                    Page:  40
  2677.  
  2678.  
  2679.  
  2680.  
  2681.  
  2682.  
  2683.         GOTO                                                          GOTO
  2684.  
  2685.  
  2686.         Summary:
  2687.         -------
  2688.  
  2689.         This command allows you to transfer control of  a GRASP  program to
  2690.         another  portion  of  the  program,  similar to the same command in
  2691.         BASIC. You must first define a label at  the point  you want  to go
  2692.         to. Labels  are defined  as any  string of  less than 16 characters
  2693.         terminated by a colon (:).
  2694.  
  2695.  
  2696.         Syntax:
  2697.         ------
  2698.  
  2699.         GOTO label
  2700.  
  2701.         where 'label' is defined somewhere else in the program.
  2702.  
  2703.  
  2704.         Example:
  2705.         -------
  2706.  
  2707.         GOTO here
  2708.  
  2709.         will transfer control to the  line  which  begins  with  the string
  2710.         'here:'. There  may only  be one  label of a particular name in one
  2711.         GRASP program. 
  2712.  
  2713.  
  2714.         Comments:
  2715.         --------
  2716.  
  2717.         You may have up to 512 labels in a GRASP program.  
  2718.  
  2719.  
  2720.  
  2721.  
  2722.  
  2723.  
  2724.  
  2725.  
  2726.  
  2727.  
  2728.  
  2729.  
  2730.  
  2731.  
  2732.  
  2733.  
  2734.  
  2735.  
  2736.                    GRASP - Graphical System for Presentation
  2737.                                    Page:  41
  2738.  
  2739.  
  2740.  
  2741.  
  2742.  
  2743.  
  2744.         IFKEY                                                        IFKEY
  2745.  
  2746.  
  2747.         Summary:
  2748.         -------
  2749.  
  2750.         IFKEY allows conditional branching by means of an  implied goto. If
  2751.         the  key  indicated  in  the  command  matches the last key pressed
  2752.         during a waitkey command, branching occurs.
  2753.  
  2754.  
  2755.         Syntax:
  2756.         ------
  2757.  
  2758.         IFKEY key label
  2759.  
  2760.         where key is the key code  to  compare  to  and  label  is  a label
  2761.         defined elsewhere in the program.
  2762.  
  2763.  
  2764.         Example:
  2765.         -------
  2766.  
  2767.         IFKEY 1 part1
  2768.  
  2769.         means that  if, during  the last  waitkey command,  the '1' key was
  2770.         pressed, goto label "PART1".
  2771.  
  2772.  
  2773.         Comments:
  2774.         --------
  2775.  
  2776.         Valid keys are all numeric and letter keys, F1-F10, UP, DN, LF, RT,
  2777.         PGUP, PGDN, HOME, END.
  2778.  
  2779.  
  2780.  
  2781.  
  2782.  
  2783.  
  2784.  
  2785.  
  2786.  
  2787.  
  2788.  
  2789.  
  2790.  
  2791.  
  2792.  
  2793.  
  2794.  
  2795.  
  2796.  
  2797.                    GRASP - Graphical System for Presentation
  2798.                                    Page:  42
  2799.  
  2800.  
  2801.  
  2802.  
  2803.  
  2804.  
  2805.         LINE                                                          LINE
  2806.  
  2807.  
  2808.         Summary:
  2809.         -------
  2810.  
  2811.         LINE allows  you to draw a single pixel width line on the screen in
  2812.         the current drawing color.
  2813.  
  2814.  
  2815.         Syntax:
  2816.         ------
  2817.  
  2818.         LINE startx, starty, endx, endy
  2819.  
  2820.         where 'startx' and 'starty' is the location for the first  point in
  2821.         the line  and 'endx'  and 'endy' is the location for the last point
  2822.         in the line.
  2823.  
  2824.  
  2825.         Example:
  2826.         -------
  2827.  
  2828.         LINE 0,0,100,100
  2829.  
  2830.         will draw a line in the  current drawing  color from   x=0,  y=0 to
  2831.         x=100, y=100.
  2832.  
  2833.  
  2834.         Comments:
  2835.         --------
  2836.  
  2837.         Transparent  mode  does  not  affect  this  command.  LINE  is  not
  2838.         available in text modes.
  2839.  
  2840.  
  2841.  
  2842.  
  2843.  
  2844.  
  2845.  
  2846.  
  2847.  
  2848.  
  2849.  
  2850.  
  2851.  
  2852.  
  2853.  
  2854.  
  2855.  
  2856.  
  2857.  
  2858.                    GRASP - Graphical System for Presentation
  2859.                                    Page:  43
  2860.  
  2861.  
  2862.  
  2863.  
  2864.  
  2865.  
  2866.         LINK                                                          LINK
  2867.  
  2868.  
  2869.         Summary:
  2870.         -------
  2871.  
  2872.         This command is used to link to another  text command  file. IF you
  2873.         wish  to  have  several  special effects, and for editing purposes,
  2874.         keep them is separate ASCII files, you may  link them  during GRASP
  2875.         run time with this command.
  2876.  
  2877.  
  2878.         Syntax:
  2879.         ------
  2880.  
  2881.         LINK txtfile
  2882.  
  2883.         where  'txtfile'  is  the  name  of  the  command  file you wish to
  2884.         execute. File  name  extensions  are  not  required,  but  all text
  2885.         command files must have an extension of txt.
  2886.  
  2887.  
  2888.         Example:
  2889.         -------
  2890.  
  2891.         LINK race
  2892.  
  2893.         will  link  to  the  text  command  file  'race.txt'  and  continue
  2894.         executing.
  2895.  
  2896.  
  2897.         Comments:
  2898.         --------
  2899.  
  2900.         Since this command requires  interpretation of  the command itself,
  2901.         the loading  of a  new file,  and the  interpretation of the second
  2902.         file, it has a tendency to slow things down. It is recommended that
  2903.         all  commands  be  put  into  one file before giving a presentation
  2904.         using GRASP. This command is useful  during development,  or if you
  2905.         have stored  several effects  from previous demonstrations and want
  2906.         to link them together.
  2907.  
  2908.  
  2909.  
  2910.  
  2911.  
  2912.  
  2913.  
  2914.  
  2915.  
  2916.  
  2917.  
  2918.  
  2919.                    GRASP - Graphical System for Presentation
  2920.                                    Page:  44
  2921.  
  2922.  
  2923.  
  2924.  
  2925.  
  2926.  
  2927.         LOOP                                                          LOOP
  2928.  
  2929.  
  2930.         Summary:
  2931.         -------
  2932.  
  2933.         This command causes the  GRASP  interpreter  to  loop  back  to the
  2934.         previous mark.  This will  happen n number of times, where n is the
  2935.         number specified in the previous MARK command.
  2936.  
  2937.  
  2938.         Syntax:
  2939.         ------
  2940.  
  2941.         LOOP
  2942.  
  2943.  
  2944.         Example:
  2945.         -------
  2946.  
  2947.         LOOP
  2948.  
  2949.         will loop to previous mark.
  2950.  
  2951.  
  2952.         Comments:
  2953.         --------
  2954.  
  2955.         MARK/LOOP pairs may be nested up to 16 levels deep.
  2956.  
  2957.  
  2958.  
  2959.  
  2960.  
  2961.  
  2962.  
  2963.  
  2964.  
  2965.  
  2966.  
  2967.  
  2968.  
  2969.  
  2970.  
  2971.  
  2972.  
  2973.  
  2974.  
  2975.  
  2976.  
  2977.  
  2978.  
  2979.  
  2980.                    GRASP - Graphical System for Presentation
  2981.                                    Page:  45
  2982.  
  2983.  
  2984.  
  2985.  
  2986.  
  2987.  
  2988.         MARK                                                         MARK
  2989.  
  2990.  
  2991.         Summary:
  2992.         -------
  2993.  
  2994.         This command is used to mark a position which will be the  top of a
  2995.         loop. Coupled  with the LOOP command, MARK allows you to repeat the
  2996.         same steps in your GRASP command file a specified number of times.
  2997.  
  2998.  
  2999.         Syntax:
  3000.         ------
  3001.  
  3002.         MARK xxx
  3003.  
  3004.         where 'xxx' is the number of times you  wish to  loop back  to this
  3005.         mark.
  3006.  
  3007.  
  3008.         Example:
  3009.         -------
  3010.  
  3011.         MARK 10
  3012.  
  3013.         will  place  a  mark  at  this  point  so that the next time a LOOP
  3014.         command is encountered, the program will  loop back  to this point.
  3015.         This process will occur ten times.
  3016.  
  3017.  
  3018.         Comments:
  3019.         --------
  3020.  
  3021.         MARK/LOOP pairs  may be  nested up  to 16  levels deep. The maximum
  3022.         number of times you can loop is 65535.
  3023.  
  3024.  
  3025.  
  3026.  
  3027.  
  3028.  
  3029.  
  3030.  
  3031.  
  3032.  
  3033.  
  3034.  
  3035.  
  3036.  
  3037.  
  3038.  
  3039.  
  3040.  
  3041.                    GRASP - Graphical System for Presentation
  3042.                                    Page:  46
  3043.  
  3044.  
  3045.  
  3046.  
  3047.  
  3048.  
  3049.         MODE                                                          MODE
  3050.  
  3051.  
  3052.         Summary:
  3053.         -------
  3054.  
  3055.         Mode is used in IBM CGA 4 color mode and IBM CGA 2 color mode only.
  3056.         It is used to set the palette and border color in these modes. 
  3057.  
  3058.  
  3059.         Syntax:
  3060.         ------
  3061.  
  3062.         MODE border color, palette
  3063.  
  3064.         where 'border  color' refers  to the  background color in IBM CGA 4
  3065.         color mode and foreground color in  IBM CGA  2 color  mode. 'Border
  3066.         color' can  be in  the range  0-15. Palette  affects only IBM CGA 4
  3067.         color mode and is in the range 0-5.  Refer to  the following tables
  3068.         for specifics.
  3069.  
  3070.  
  3071.         Border                                 Color Table
  3072.         Color    Color       Palette   1            2              3
  3073.         -----    -----       ------- -----------------------------------
  3074.           0      Black          0    Cyan         Magenta         White
  3075.           1      Blue           1    Green        Red             Brown
  3076.           2      Green          2    Cyan         Red             White
  3077.           3      Cyan           3    Bright Cyan  Bright Magenta  White
  3078.           4      Red            4    Bright Green Bright Red      Yellow
  3079.           5      Magenta        5    Bright Cyan  Bright Red      White
  3080.           6      Brown       -------------------------------------------
  3081.           7      Grey 
  3082.           8      Dark Grey (Bright Black)
  3083.           9      Bright Blue
  3084.          10      Bright Green
  3085.          11      Bright Cyan
  3086.          12      Bright Red
  3087.          13      Bright Magenta
  3088.          14      Yellow (Bright Brown)
  3089.          15      White (Bright Grey)
  3090.  
  3091.  
  3092.         In  the  above  Palette  table,  color  0 is the currently selected
  3093.         Border Color.
  3094.           
  3095.  
  3096.         Example:
  3097.         -------
  3098.  
  3099.         Mode 1,4
  3100.  
  3101.  
  3102.                    GRASP - Graphical System for Presentation
  3103.                                    Page:  47
  3104.  
  3105.  
  3106.  
  3107.  
  3108.  
  3109.  
  3110.         will yield the following: (Assuming  we  are  in  IBM  CGA  4 color
  3111.         mode), border color is blue (Drawing Color 0), and the palette will
  3112.         be bright cyan, bright magenta, and white. (Drawing  colors 1,2 and
  3113.         3, respectively)  in IBM CGA 4 color mode. In IBM CGA 2 color mode,
  3114.         The foreground color will be blue.
  3115.  
  3116.  
  3117.         Comments:
  3118.         --------
  3119.  
  3120.         This command was intended for use only in IBM CGA  4 color  and IBM
  3121.         CGA 2  color modes.  Use in  any other  mode may result in an error
  3122.         message. 
  3123.  
  3124.  
  3125.  
  3126.  
  3127.  
  3128.  
  3129.  
  3130.  
  3131.  
  3132.  
  3133.  
  3134.  
  3135.  
  3136.  
  3137.  
  3138.  
  3139.  
  3140.  
  3141.  
  3142.  
  3143.  
  3144.  
  3145.  
  3146.  
  3147.  
  3148.  
  3149.  
  3150.  
  3151.  
  3152.  
  3153.  
  3154.  
  3155.  
  3156.  
  3157.  
  3158.  
  3159.  
  3160.  
  3161.  
  3162.  
  3163.                    GRASP - Graphical System for Presentation
  3164.                                    Page:  48
  3165.  
  3166.  
  3167.  
  3168.  
  3169.  
  3170.  
  3171.         MOVE                                                          MOVE
  3172.  
  3173.  
  3174.         Summary:
  3175.         -------
  3176.  
  3177.         MOVE allows you to move a region of the screen. 
  3178.  
  3179.  
  3180.         Syntax:
  3181.         ------
  3182.  
  3183.         MOVE  x, y, x1, y1, dx0, dy0
  3184.  
  3185.         where 'x, y' is the location of the lower left corner of the source
  3186.         area, 'x1, y1' is the opposite corner of the source area, and 'dx0,
  3187.         dy0' is the lower left corner of the destination area. 
  3188.  
  3189.  
  3190.         Example:
  3191.         -------
  3192.  
  3193.         MOVE 0,0,319,198,0,1
  3194.  
  3195.         will move the entire screen (in  this  case,  video  mode  A)  up 1
  3196.         pixel.  Remember  that  the  coordinates  must  correspond to valid
  3197.         coordinates for the current video mode.  
  3198.  
  3199.  
  3200.         Comments:
  3201.         --------
  3202.  
  3203.  
  3204.  
  3205.  
  3206.  
  3207.  
  3208.  
  3209.  
  3210.  
  3211.  
  3212.  
  3213.  
  3214.  
  3215.  
  3216.  
  3217.  
  3218.  
  3219.  
  3220.  
  3221.  
  3222.  
  3223.  
  3224.                    GRASP - Graphical System for Presentation
  3225.                                    Page:  49
  3226.  
  3227.  
  3228.  
  3229.  
  3230.  
  3231.  
  3232.         NOISE                                                        NOISE
  3233.  
  3234.  
  3235.         Summary:
  3236.         -------
  3237.  
  3238.         NOISE allows you to make music in GRASP. By specifying starting and
  3239.         ending  frequencies,  as  well  as  a duration, you can make single
  3240.         notes, or complex sounds.
  3241.  
  3242.  
  3243.         Syntax:
  3244.         ------
  3245.  
  3246.         NOISE startfreq, endfreq, duration
  3247.  
  3248.         where 'startfreq' and 'startfreq' are the  starting frequencies for
  3249.         the noise and 'duration' is the overall length of the noise.
  3250.  
  3251.  
  3252.         Example:
  3253.         -------
  3254.  
  3255.         NOISE 440,440,100
  3256.  
  3257.         will play the note with a frequency 440 for duration 100.
  3258.  
  3259.  
  3260.         Comments:
  3261.         --------
  3262.  
  3263.  
  3264.  
  3265.  
  3266.  
  3267.  
  3268.  
  3269.  
  3270.  
  3271.  
  3272.  
  3273.  
  3274.  
  3275.  
  3276.  
  3277.  
  3278.  
  3279.  
  3280.  
  3281.  
  3282.  
  3283.  
  3284.  
  3285.                    GRASP - Graphical System for Presentation
  3286.                                    Page:  50
  3287.  
  3288.  
  3289.  
  3290.  
  3291.  
  3292.  
  3293.         OFFSET                                                      OFFSET
  3294.  
  3295.  
  3296.         Summary:
  3297.         -------
  3298.  
  3299.         The  OFFSET  command  allows  you  to  treat  coordinates  in other
  3300.         commands  (like  putup,  line,  box,  cfade,  etc...)  as  relative
  3301.         coordinates rather than absolute. If the OFFSET is set to 0,0, then
  3302.         the coordinates you enter in the other commands are relative to the
  3303.         screen as  a whole  which appears  to be  absolute. This command is
  3304.         used when you want to repeat a series of operations  but don't want
  3305.         to have  to alter  all the  coordinates in order to use a different
  3306.         region of the screen.
  3307.  
  3308.  
  3309.         Syntax:
  3310.         ------
  3311.  
  3312.         OFFSET x,y,<r>
  3313.  
  3314.         where 'x' and 'y' are the x and y offset  values and  'r' indicates
  3315.         whether or not to make the offset RELATIVE to previous offset.
  3316.  
  3317.  
  3318.         Example:
  3319.         -------
  3320.  
  3321.         OFFSET 40,32
  3322.  
  3323.         will set  the offset  to x=40, y=32. This means that if you specify
  3324.         that you want a line drawn from 0,0 to 10,10, it will actually draw
  3325.         it from 40,32 to 50,42. In other words, the offset values are added
  3326.         to the coordinate data you type in the command.
  3327.  
  3328.  
  3329.         Comments:
  3330.         --------
  3331.  
  3332.  
  3333.  
  3334.  
  3335.  
  3336.  
  3337.  
  3338.  
  3339.  
  3340.  
  3341.  
  3342.  
  3343.  
  3344.  
  3345.  
  3346.                    GRASP - Graphical System for Presentation
  3347.                                    Page:  51
  3348.  
  3349.  
  3350.  
  3351.  
  3352.  
  3353.  
  3354.         PALETTE                                                    PALETTE
  3355.  
  3356.  
  3357.         Summary:
  3358.         -------
  3359.  
  3360.         Palette is used to set the current palette to that of the specified
  3361.         picture  which  has  been  loaded  into  a buffer. This sets the 16
  3362.         colors out of 64 on  EGA  16  color  modes  and  the border-palette
  3363.         combination of CGA 4 color mode.
  3364.  
  3365.  
  3366.         Syntax:
  3367.         ------
  3368.  
  3369.         PALETTE buffer number
  3370.  
  3371.         Where  'buffer  number'  is  the  number of the buffer in which the
  3372.         picture resides.
  3373.  
  3374.  
  3375.         Example:
  3376.         -------
  3377.  
  3378.         PALETTE 2
  3379.  
  3380.         will set the current palette to  the palette  used for  the picture
  3381.         which was loaded into buffer 2 with the PLOAD command.
  3382.  
  3383.  
  3384.         Comments:
  3385.         --------
  3386.  
  3387.         This command  was intended  for use  in EGA 16 color mode and CGA 4
  3388.         color  mode  only.  Use  in  other  modes  may  cause unpredictable
  3389.         results. Use with caution.
  3390.  
  3391.  
  3392.  
  3393.  
  3394.  
  3395.  
  3396.  
  3397.  
  3398.  
  3399.  
  3400.  
  3401.  
  3402.  
  3403.  
  3404.  
  3405.  
  3406.  
  3407.                    GRASP - Graphical System for Presentation
  3408.                                    Page:  52
  3409.  
  3410.  
  3411.  
  3412.  
  3413.  
  3414.  
  3415.         PAN                                                           PAN
  3416.  
  3417.  
  3418.         Summary:
  3419.         -------
  3420.  
  3421.         This  command  allows  you  to  perform  a  hardware pan if you are
  3422.         operating in one of the EGA modes. If the picture  you want  to pan
  3423.         around on  is larger  than a screen then the following rules apply:
  3424.         1) You MUST use PFADE number 0 to put up  the picture,  2) when you
  3425.         are  finished  panning  and  scrolling, you MUST PFREE the picture,
  3426.         clear the screen with CLEARSCR, then do a RESETSCR before using any
  3427.         other pictures.  This is so that the EGA will be able to keep track
  3428.         of which picture you are using  and how  to best  display it. Also,
  3429.         sequences  of   PAN  commands  should  always  return  you  to  the
  3430.         coordinate 0,0 when you are done. Think of  the picture  as being a
  3431.         very large  screen with the upper left corner being coordinate 0,0.
  3432.         Pan  then  allows  you  to  change  upper  left  corner  to  be any
  3433.         coordinate in the valid coordinate space.
  3434.  
  3435.  
  3436.         Syntax:
  3437.         ------
  3438.  
  3439.         PAN x0,y0,x1,y1,buffer
  3440.  
  3441.         where 'x0',  'y0' is  the starting coordinate for panning and 'x1',
  3442.         'y1' is the ending coordinate. 'Buffer' is the  picture buffer that
  3443.         the command  will look into to get real picture coordinates and set
  3444.         the EGA display modes to coincide to.
  3445.  
  3446.  
  3447.         Example:
  3448.         -------
  3449.  
  3450.         PAN 0,0,100,100,1
  3451.         PAN 100,100,0,0,1
  3452.  
  3453.         will smoothly pan the screen diagonally from the  upper left corner
  3454.         to 100,100 and back again.
  3455.  
  3456.  
  3457.         Comments:
  3458.         --------
  3459.  
  3460.         This  is  a  complicated  command  and requires some thought to use
  3461.         effectively. Be careful.
  3462.  
  3463.  
  3464.  
  3465.  
  3466.  
  3467.  
  3468.                    GRASP - Graphical System for Presentation
  3469.                                    Page:  53
  3470.  
  3471.  
  3472.  
  3473.  
  3474.  
  3475.  
  3476.         PFADE                                                        PFADE
  3477.  
  3478.         Summary:
  3479.         -------
  3480.  
  3481.         Pfade is the heart of GRASP. It allows you to dissolve a picture to
  3482.         the screen. You may specify one of several dissolves, the speed for
  3483.         that dissolve, and a delay after the dissolve.
  3484.  
  3485.  
  3486.         Syntax:
  3487.         ------
  3488.  
  3489.         PFADE fade number, buffer number, speed, delay
  3490.  
  3491.         where 'fade  number' is  the number  of the  fade you  want to use,
  3492.         'buffer number'  is the picture buffer number where the picture you
  3493.         want to fade has been loaded, 'speed' is the speed of the  fade and
  3494.         'delay' is  the time  to wait  after the delay. Speed can be in the
  3495.         range 0-10000. Check Appendix B for a list of fades.
  3496.  
  3497.  
  3498.         Example:
  3499.         -------
  3500.  
  3501.         PFADE 12,1,500,1000
  3502.  
  3503.         will fade the picture in buffer 1 using  fade 12  at speed  500 and
  3504.         then  wait  1000.  The  delay  works  the same as using the WAITKEY
  3505.         command. 
  3506.  
  3507.  
  3508.         Comments:
  3509.         --------
  3510.  
  3511.         The first 25 fades in GRASP are the same in all video  modes. Fades
  3512.         beyond  25  may  be  mode  specific  and must be used with caution.
  3513.         Specifying buffer 0 will  cause a  blank screen  of current drawing
  3514.         color to  be generated  and faded  to the  screen. Transparent mode
  3515.         does NOT apply to PFADE.
  3516.  
  3517.  
  3518.  
  3519.  
  3520.  
  3521.  
  3522.  
  3523.  
  3524.  
  3525.  
  3526.  
  3527.  
  3528.  
  3529.                    GRASP - Graphical System for Presentation
  3530.                                    Page:  54
  3531.  
  3532.  
  3533.  
  3534.  
  3535.  
  3536.  
  3537.         PFREE                                                        PFREE
  3538.  
  3539.  
  3540.         Summary:
  3541.         -------
  3542.  
  3543.         PFREE is used to free-up a picture buffer.  Sometimes, you  may run
  3544.         out of  memory and  need to  clear up some buffers you have full of
  3545.         pictures you have already used.
  3546.  
  3547.  
  3548.         Syntax:
  3549.         ------
  3550.  
  3551.         PFREE buf1, buf2, buf3...
  3552.  
  3553.         where 'buf1' and other buffers are buffers you want to free-up.
  3554.  
  3555.  
  3556.         Example:
  3557.         -------
  3558.  
  3559.         PFREE 1,2
  3560.  
  3561.         will free-up picture buffers 1 and 2.
  3562.  
  3563.  
  3564.         Comments:
  3565.         --------
  3566.  
  3567.         This is especially useful in  EGA  16  color  mode  where  space is
  3568.         critical.
  3569.  
  3570.  
  3571.  
  3572.  
  3573.  
  3574.  
  3575.  
  3576.  
  3577.  
  3578.  
  3579.  
  3580.  
  3581.  
  3582.  
  3583.  
  3584.  
  3585.  
  3586.  
  3587.  
  3588.  
  3589.  
  3590.                    GRASP - Graphical System for Presentation
  3591.                                    Page:  55
  3592.  
  3593.  
  3594.  
  3595.  
  3596.  
  3597.  
  3598.         PLOAD                                                        PLOAD
  3599.  
  3600.  
  3601.         Summary:
  3602.         -------
  3603.  
  3604.         This command is used to load a picture into a buffer. There are  16
  3605.         buffers available for pictures in GRASP. It is  advised, for memory
  3606.         reasons,  that  the  user  try  to  manage using only one buffer. A
  3607.         picture must be loaded  into a  buffer before  it can  be dissolved
  3608.         onto the screen.
  3609.  
  3610.  
  3611.         Syntax:
  3612.         ------
  3613.  
  3614.         PLOAD picture,buffer number
  3615.  
  3616.         where 'picture'  is the  name of  the picture you want to load (the
  3617.         file name extension is optional) and 'buffer number'  is the number
  3618.         of the  buffer you  want to  load in to. Valid buffer numbers are 1
  3619.         through 16. Buffer 0 is a dummy buffer  used for  solid color wipes
  3620.         and changes, and thus, no picture may be loaded into it.
  3621.  
  3622.  
  3623.         Example:
  3624.         -------
  3625.  
  3626.         PLOAD mypic,1
  3627.  
  3628.         will load the picture myfile.pic into picture buffer number 1.
  3629.  
  3630.  
  3631.         Comments:
  3632.         --------
  3633.  
  3634.  
  3635.  
  3636.  
  3637.  
  3638.  
  3639.  
  3640.  
  3641.  
  3642.  
  3643.  
  3644.  
  3645.  
  3646.  
  3647.  
  3648.  
  3649.  
  3650.  
  3651.                    GRASP - Graphical System for Presentation
  3652.                                    Page:  56
  3653.  
  3654.  
  3655.  
  3656.  
  3657.  
  3658.  
  3659.         POINT                                                        POINT
  3660.  
  3661.  
  3662.         Summary:
  3663.         -------
  3664.  
  3665.         POINT  allows  you  to  draw  a  single  pixel on the screen in the
  3666.         current drawing  color. If  a second  point is  indicated, a random
  3667.         point  is  drawn  in  the  rectangular  region  defined  by  the  4
  3668.         coordinates.
  3669.  
  3670.  
  3671.         Syntax:
  3672.         ------
  3673.  
  3674.         POINT startx, starty, <endx, endy>
  3675.  
  3676.         where 'startx' and 'starty'  is  the  location  for  the  point and
  3677.         'endx' and 'endy' define the region for randomization.
  3678.  
  3679.  
  3680.         Example:
  3681.         -------
  3682.  
  3683.         POINT 50,50
  3684.  
  3685.         will draw a point in the current drawing color at x=50, y=50.
  3686.  
  3687.         POINT 100,100,150,150
  3688.  
  3689.         will draw a random point in the region defined by 100,100,150,150.
  3690.  
  3691.  
  3692.         Comments:
  3693.         --------
  3694.          
  3695.         Transparent mode does not affect this command.
  3696.  
  3697.  
  3698.  
  3699.  
  3700.  
  3701.  
  3702.  
  3703.  
  3704.  
  3705.  
  3706.  
  3707.  
  3708.  
  3709.  
  3710.  
  3711.  
  3712.                    GRASP - Graphical System for Presentation
  3713.                                    Page:  57
  3714.  
  3715.  
  3716.  
  3717.  
  3718.  
  3719.  
  3720.         POSITION                                                  POSITION
  3721.  
  3722.  
  3723.         Summary:
  3724.         -------
  3725.  
  3726.         This command  is used  to set  the current  x,y location  in a page
  3727.         buffer where the fade commands will start. It is useful for setting
  3728.         up large pages and software-panning.
  3729.  
  3730.  
  3731.         Syntax:
  3732.         ------
  3733.  
  3734.         POSITION buffer,x,y,<r>
  3735.  
  3736.         where 'buffer'  is the page buffer to set the position in, 'x,y' is
  3737.         the location, and 'r'  is  an  optional  parameter  which indicates
  3738.         whether  or  not  to  make  this  position  RELATIVE to the current
  3739.         position. Adding the ',r' will indicate relative, omitting it means
  3740.         absolute position.
  3741.  
  3742.  
  3743.         Example:
  3744.         -------
  3745.  
  3746.         POSITION 1,100,204 
  3747.  
  3748.         will set the current position into buffer 1 to 100,204.
  3749.  
  3750.  
  3751.         Comments:
  3752.         --------
  3753.  
  3754.         Works only with EGA modes and PAN command.
  3755.  
  3756.  
  3757.  
  3758.  
  3759.  
  3760.  
  3761.  
  3762.  
  3763.  
  3764.  
  3765.  
  3766.  
  3767.  
  3768.  
  3769.  
  3770.  
  3771.  
  3772.  
  3773.                    GRASP - Graphical System for Presentation
  3774.                                    Page:  58
  3775.  
  3776.  
  3777.  
  3778.  
  3779.  
  3780.  
  3781.         PUTUP                                                       PUTUP
  3782.  
  3783.  
  3784.         Summary:
  3785.         -------
  3786.  
  3787.         PUTUP  allows  you  to  place  a  clipping  on the screen. PUTUP is
  3788.         similar to CFADE 0, but allows  placement at  any x  and y location
  3789.         and supports transparent mode.
  3790.  
  3791.  
  3792.         Syntax:
  3793.         ------
  3794.  
  3795.         PUTUP x ,y, <buffer number>, <delay>
  3796.  
  3797.         where 'x'  and 'y'  are the location where the lower left corner of
  3798.         the clipping will be placed, 'buffer number' is the clipping buffer
  3799.         number where  the clipping  you want to put up resides and delay is
  3800.         the time to wait after the putup in hundredths of a second.
  3801.  
  3802.  
  3803.         Example:
  3804.         -------
  3805.  
  3806.         PUTUP 25,50,1,1000
  3807.  
  3808.         will put the clipping in buffer 1 up  on the  screen at  x=25, y=50
  3809.         and then wait for time 1000 (10 seconds). Remember that the x and y
  3810.         coordinates correspond to the  current video  mode. Exceeding these
  3811.         coordinates may result in an error message.
  3812.  
  3813.  
  3814.         Comments:
  3815.         --------
  3816.  
  3817.         Also see CFREE.
  3818.  
  3819.  
  3820.  
  3821.  
  3822.  
  3823.  
  3824.  
  3825.  
  3826.  
  3827.  
  3828.  
  3829.  
  3830.  
  3831.  
  3832.  
  3833.  
  3834.                    GRASP - Graphical System for Presentation
  3835.                                    Page:  59
  3836.  
  3837.  
  3838.  
  3839.  
  3840.  
  3841.  
  3842.         RECT                                                        RECT
  3843.  
  3844.  
  3845.         Summary:
  3846.         -------
  3847.  
  3848.         RECT  allows  you  to  draw  a  fast filled rectangle on the screen
  3849.         defined by the boundaries specified.  It  is  useful  when  used in
  3850.         conjunction with  the scroll command. The rectangle is drawn in the
  3851.         current drawing color.
  3852.  
  3853.  
  3854.         Syntax:
  3855.         ------
  3856.  
  3857.         RECT x ,y, x1, y1
  3858.  
  3859.         where 'x' and 'y' are the  lower left  corner of  the rectangle and
  3860.         x1, y1 is the upper right corner.
  3861.  
  3862.  
  3863.         Example:
  3864.         -------
  3865.  
  3866.         RECT 25,50,100,100
  3867.  
  3868.         will draw  a filled  rectangle from 25,50 to 100,100 in the current
  3869.         drawing color.
  3870.  
  3871.  
  3872.         Comments:
  3873.         --------
  3874.  
  3875.  
  3876.  
  3877.  
  3878.  
  3879.  
  3880.  
  3881.  
  3882.  
  3883.  
  3884.  
  3885.  
  3886.  
  3887.  
  3888.  
  3889.  
  3890.  
  3891.  
  3892.  
  3893.  
  3894.  
  3895.                    GRASP - Graphical System for Presentation
  3896.                                    Page:  60
  3897.  
  3898.  
  3899.  
  3900.  
  3901.  
  3902.  
  3903.         RESETSCR                                                   RESETSCR
  3904.  
  3905.  
  3906.         Summary:
  3907.         -------
  3908.  
  3909.         This command is used to reset  the virtual  screen back  to display
  3910.         screen size after a PAN command with a larger-than-screen picture.
  3911.  
  3912.  
  3913.         Syntax:
  3914.         ------
  3915.  
  3916.         RESETSCR
  3917.  
  3918.  
  3919.         Example:
  3920.         -------
  3921.  
  3922.         RESETSCR 
  3923.  
  3924.         will reset the virtual screen image.
  3925.  
  3926.  
  3927.         Comments:
  3928.         --------
  3929.  
  3930.         Works only with EGA modes and PAN command.
  3931.  
  3932.  
  3933.  
  3934.  
  3935.  
  3936.  
  3937.  
  3938.  
  3939.  
  3940.  
  3941.  
  3942.  
  3943.  
  3944.  
  3945.  
  3946.  
  3947.  
  3948.  
  3949.  
  3950.  
  3951.  
  3952.  
  3953.  
  3954.  
  3955.  
  3956.                    GRASP - Graphical System for Presentation
  3957.                                    Page:  61
  3958.  
  3959.  
  3960.  
  3961.  
  3962.  
  3963.  
  3964.         RETURN                                                       RETURN
  3965.  
  3966.  
  3967.         Summary:
  3968.         -------
  3969.  
  3970.         This command  causes execution  of the  current sub-program to halt
  3971.         and return control to the calling program.
  3972.  
  3973.  
  3974.         Syntax:
  3975.         ------
  3976.  
  3977.         RETURN
  3978.  
  3979.  
  3980.         Example:
  3981.         -------
  3982.  
  3983.         RETURN
  3984.  
  3985.         will return control to calling program.
  3986.  
  3987.  
  3988.         Comments:
  3989.         --------
  3990.  
  3991.         Also see command GOSUB.
  3992.  
  3993.  
  3994.  
  3995.  
  3996.  
  3997.  
  3998.  
  3999.  
  4000.  
  4001.  
  4002.  
  4003.  
  4004.  
  4005.  
  4006.  
  4007.  
  4008.  
  4009.  
  4010.  
  4011.  
  4012.  
  4013.  
  4014.  
  4015.  
  4016.  
  4017.                    GRASP - Graphical System for Presentation
  4018.                                    Page:  62
  4019.  
  4020.  
  4021.  
  4022.  
  4023.  
  4024.  
  4025.         SETCOLOR                                                  SETCOLOR
  4026.  
  4027.  
  4028.         Summary:
  4029.         -------
  4030.  
  4031.         Setcolor is used to set the color palette  registers in  IBM EGA 16
  4032.         color modes.  On the  EGA, there  are 16 possible colors, called an
  4033.         'index', and each of  these color  indices may  be one  of 64 color
  4034.         'values'. SETCOLOR  differs from CHGCOLOR in that SETCOLOR sets all
  4035.         16 color  indices  at  once.  This  is  faster  and  is  useful for
  4036.         animation effects.
  4037.  
  4038.  
  4039.         Syntax:
  4040.         ------
  4041.  
  4042.         SETCOLOR color value 1, color value 2, ... color value 16
  4043.  
  4044.         where 'color value n' lies in the range 0-63.
  4045.  
  4046.  
  4047.         Example:
  4048.         -------
  4049.  
  4050.         SETCOLOR 3,32,23,53,12,11,10,21,35,2,4,8,30,40,61,63
  4051.  
  4052.         will  set  the  current  palette  registers  to the 16 color values
  4053.         specified.
  4054.  
  4055.  
  4056.         Comments:
  4057.         --------
  4058.  
  4059.         Remember, this only works  in EGA  16 color  modes and  requires an
  4060.         Enhanced Color Display (ECD).
  4061.  
  4062.  
  4063.  
  4064.  
  4065.  
  4066.  
  4067.  
  4068.  
  4069.  
  4070.  
  4071.  
  4072.  
  4073.  
  4074.  
  4075.  
  4076.  
  4077.  
  4078.                    GRASP - Graphical System for Presentation
  4079.                                    Page:  63
  4080.  
  4081.  
  4082.  
  4083.  
  4084.  
  4085.  
  4086.         SETUPSCR                                                  SETUPSCR
  4087.  
  4088.  
  4089.         Summary:
  4090.         -------
  4091.  
  4092.         This command  is used to set the virtual screen to page size before
  4093.         a PAN command with a larger-than-screen picture.
  4094.  
  4095.  
  4096.         Syntax:
  4097.         ------
  4098.  
  4099.         SETUPSCR buffer
  4100.  
  4101.  
  4102.         Example:
  4103.         -------
  4104.  
  4105.         SETUPSCR 1 
  4106.  
  4107.         will setup the virtual buffer according to the  picture loaded into
  4108.         buffer 1.
  4109.  
  4110.  
  4111.         Comments:
  4112.         --------
  4113.  
  4114.         Works only with EGA modes and PAN command. Default is buffer 1.
  4115.  
  4116.  
  4117.  
  4118.  
  4119.  
  4120.  
  4121.  
  4122.  
  4123.  
  4124.  
  4125.  
  4126.  
  4127.  
  4128.  
  4129.  
  4130.  
  4131.  
  4132.  
  4133.  
  4134.  
  4135.  
  4136.  
  4137.  
  4138.  
  4139.                    GRASP - Graphical System for Presentation
  4140.                                    Page:  64
  4141.  
  4142.  
  4143.  
  4144.  
  4145.  
  4146.  
  4147.         TEXT                                                          TEXT
  4148.  
  4149.  
  4150.         Summary:
  4151.         -------
  4152.  
  4153.         TEXT allows  you to put-up a string of text in the font loaded with
  4154.         FLOAD in the current drawing color.
  4155.  
  4156.  
  4157.         Syntax:
  4158.         ------
  4159.  
  4160.         TEXT x, y, string, <delay>
  4161.  
  4162.         where 'x' and 'y' is the location of the lower  left corner  of the
  4163.         first character in the string, 'string' is the string to put up and
  4164.         'delay' is the time  to wait  after the  put-up in  hundredths of a
  4165.         second.
  4166.  
  4167.  
  4168.         Example:
  4169.         -------
  4170.  
  4171.         TEXT 4,4,"This is a text string..."
  4172.  
  4173.         will put  the string  indicated between  the quotes up at x=4, y=4,
  4174.         using the current drawing color.
  4175.  
  4176.  
  4177.         Comments:
  4178.         --------
  4179.  
  4180.         The string to be put must be in double quotes.
  4181.  
  4182.  
  4183.  
  4184.  
  4185.  
  4186.  
  4187.  
  4188.  
  4189.  
  4190.  
  4191.  
  4192.  
  4193.  
  4194.  
  4195.  
  4196.  
  4197.  
  4198.  
  4199.  
  4200.                    GRASP - Graphical System for Presentation
  4201.                                    Page:  65
  4202.  
  4203.  
  4204.  
  4205.  
  4206.  
  4207.  
  4208.         TILE                                                          TILE
  4209.  
  4210.  
  4211.         Summary:
  4212.         -------
  4213.  
  4214.         TILE allows  you to  fill the  screen or  'tile' the  screen with a
  4215.         particular  clipping.  It  is  useful  for creating backgrounds and
  4216.         curtains.
  4217.  
  4218.  
  4219.         Syntax:
  4220.         ------
  4221.  
  4222.         TILE buffer_number
  4223.  
  4224.         where 'buffer_number' is the number of  the clipping  that you have
  4225.         loaded and want to tile the screen with.
  4226.  
  4227.  
  4228.         Example:
  4229.         -------
  4230.  
  4231.         TILE 2
  4232.  
  4233.         will tile the screen with the clipping in buffer 2.
  4234.  
  4235.  
  4236.         Comments:
  4237.         --------
  4238.  
  4239.         Remember that  you must  use a clipping from the current video mode
  4240.         and you must have NOT loaded the clipping with the  extra parameter
  4241.         that skips the shifted copies.
  4242.  
  4243.  
  4244.  
  4245.  
  4246.  
  4247.  
  4248.  
  4249.  
  4250.  
  4251.  
  4252.  
  4253.  
  4254.  
  4255.  
  4256.  
  4257.  
  4258.  
  4259.  
  4260.  
  4261.                    GRASP - Graphical System for Presentation
  4262.                                    Page:  66
  4263.  
  4264.  
  4265.  
  4266.  
  4267.  
  4268.  
  4269.         TRAN                                                          TRAN
  4270.  
  4271.  
  4272.         Summary:
  4273.         -------
  4274.  
  4275.         TRAN allows  you to  set transparent mode on or off, and to specify
  4276.         which colors to  make  transparent.  This  is  used  for overlaying
  4277.         objects or floating objects across complex backgrounds.
  4278.  
  4279.  
  4280.         Syntax:
  4281.         ------
  4282.  
  4283.         TRAN on/off, color1, color2,...colorn
  4284.  
  4285.         where 'on/off'  specifies whether  you want transparent mode turned
  4286.         on or off and color1-colorn indicate which colors you want  to make
  4287.         transparent. Color1-colorn  may have the values 0 to maxcolor where
  4288.         maxcolor is the highest  color  number  available  in  your current
  4289.         video mode.
  4290.  
  4291.  
  4292.         Example:
  4293.         -------
  4294.  
  4295.         TRAN on 2,14
  4296.  
  4297.         will  turn  transparent  mode  on  and  make  the  colors  2 and 14
  4298.         transparent.
  4299.  
  4300.         TRAN off
  4301.  
  4302.         will turn transparent mode off.
  4303.  
  4304.  
  4305.         Comments:
  4306.         --------
  4307.  
  4308.         If you turn transparent mode on and off, the next time you  turn it
  4309.         on, you  must re-specify  which colors  you want to be transparent.
  4310.         Transparent does not work in EGA 16 color modes.
  4311.  
  4312.  
  4313.  
  4314.  
  4315.  
  4316.  
  4317.  
  4318.  
  4319.  
  4320.  
  4321.  
  4322.                    GRASP - Graphical System for Presentation
  4323.                                    Page:  67
  4324.  
  4325.  
  4326.  
  4327.  
  4328.  
  4329.  
  4330.         VIDEO                                                        VIDEO
  4331.  
  4332.  
  4333.         Summary:
  4334.         -------
  4335.  
  4336.         Video is used to set the video mode. Video should  be used   at the
  4337.         beginning  of  the  GRASP  text  file.  Video  modes may be changed
  4338.         during  the  demo, but caution is advised. Damage may be  done to a
  4339.         monitor if  the wrong  video mode is requested for your system. The
  4340.         default video mode is A, (see table below).
  4341.  
  4342.  
  4343.         Syntax:
  4344.         ------
  4345.  
  4346.         VIDEO vidmode
  4347.  
  4348.         where 'vidmode' is one of the following...
  4349.  
  4350.                     Maximum       Picture         Memory
  4351.         Vidmode    Resolution   # of Colors     Requirement
  4352.         --------------------------------------------------------
  4353.            0         40x25          16         2K (IBM 40 column text)
  4354.            1         80x25          16         4K (IBM 80 column text)
  4355.            2         80x25          2          4K (IBM 80 column text)
  4356.            A        320x200         4         16K (IBM CGA)
  4357.            B        320x200         16        32K (IBM PCjr/STB)
  4358.            C        640x200         2         16K (IBM CGA)
  4359.            D        640x200       16/64       64K (IBM EGA)
  4360.            E        640x350         2         32K (IBM EGA monochrome)
  4361.            F        640x350         4         64K (IBM EGA)
  4362.            G        640x350       16/64      128K (IBM EGA)
  4363.            H        720x348         2         32K (Hercules monochrome)
  4364.            I        320x200         16        32K (Plantronics/AST CGP)
  4365.            J        320x200         16        32K (IBM EGA)
  4366.  
  4367.         These modes, (with the exception of  the text  modes) correspond to
  4368.         PCPAINT video modes.
  4369.  
  4370.  
  4371.         Example:
  4372.         -------
  4373.  
  4374.         VIDEO G
  4375.  
  4376.         Will  set  up  GRASP  to  use  the  high resolution mode of the EGA
  4377.         adapter in 16 out of 64 colors.
  4378.  
  4379.  
  4380.  
  4381.  
  4382.  
  4383.                    GRASP - Graphical System for Presentation
  4384.                                    Page:  68
  4385.  
  4386.  
  4387.  
  4388.  
  4389.  
  4390.  
  4391.         Comments:
  4392.         --------
  4393.  
  4394.         Memory requirement in the table above is the approximate amount  of
  4395.         memory required for the buffer to hold EACH picture you load in for
  4396.         use. Also, pay attention to the  size of  the screen  in each video
  4397.         mode. Attempting  to FADE  pictures other  that this size may yield
  4398.         unpredictable results. The exception to this is when  using the PAN
  4399.         command on an EGA.
  4400.  
  4401.  
  4402.  
  4403.  
  4404.  
  4405.  
  4406.  
  4407.  
  4408.  
  4409.  
  4410.  
  4411.  
  4412.  
  4413.  
  4414.  
  4415.  
  4416.  
  4417.  
  4418.  
  4419.  
  4420.  
  4421.  
  4422.  
  4423.  
  4424.  
  4425.  
  4426.  
  4427.  
  4428.  
  4429.  
  4430.  
  4431.  
  4432.  
  4433.  
  4434.  
  4435.  
  4436.  
  4437.  
  4438.  
  4439.  
  4440.  
  4441.  
  4442.  
  4443.  
  4444.                    GRASP - Graphical System for Presentation
  4445.                                    Page:  69
  4446.  
  4447.  
  4448.  
  4449.  
  4450.  
  4451.  
  4452.         WAITKEY                                                    WAITKEY
  4453.  
  4454.  
  4455.         Summary:
  4456.         -------
  4457.  
  4458.         This command  instructs the  demonstration or presentation to pause
  4459.         until a key is pressed, or  until timeout  value, if  specified. If
  4460.         timeout occurs, conditional branching is allowed.
  4461.  
  4462.  
  4463.         Syntax:
  4464.         ------
  4465.  
  4466.         WAITKEY <timeout>, <label>
  4467.  
  4468.         where 'timeout'  is the  time to wait before timeout in 100ths of a
  4469.         second and 'label' is the label to go to if timeout occurs.
  4470.  
  4471.  
  4472.         Example:
  4473.         -------
  4474.  
  4475.         WAITKEY 600,myline
  4476.  
  4477.         will wait until a key is pressed, or until delay  of 6  seconds. If
  4478.         delay of 6 seconds is reached, goto label 'myline'.
  4479.  
  4480.  
  4481.         Comments:
  4482.         --------
  4483.  
  4484.         If no  timeout is  specified, WAITKEY will wait forever until a key
  4485.         is pressed. The key that is pressed to abort the wait is  saved and
  4486.         may be tested by IFKEY.
  4487.  
  4488.  
  4489.  
  4490.  
  4491.  
  4492.  
  4493.  
  4494.  
  4495.  
  4496.  
  4497.  
  4498.  
  4499.  
  4500.  
  4501.  
  4502.  
  4503.  
  4504.  
  4505.                    GRASP - Graphical System for Presentation
  4506.                                    Page:  70
  4507.  
  4508.  
  4509.  
  4510.  
  4511.  
  4512.  
  4513.         WINDOW                                                       WINDOW
  4514.  
  4515.  
  4516.         Summary:
  4517.         -------
  4518.  
  4519.         This command  is used  to restrict  a picture  fade to a particular
  4520.         portion of the screen. The coordinates you pass are in  pixels, but
  4521.         they are rounded to the nearest byte, or usually 8 pixels.
  4522.  
  4523.  
  4524.         Syntax:
  4525.         ------
  4526.  
  4527.         WINDOW x,y,x1,y1
  4528.  
  4529.         where 'x',  'y', 'x1'  and 'y1'  are the lower left and upper right
  4530.         corner of the window to set for clipping.
  4531.  
  4532.  
  4533.         Example:
  4534.         -------
  4535.  
  4536.         WINDOW 40,40,100,160
  4537.  
  4538.         will set the fade window to  40,40,100,160. The  PFADE command will
  4539.         only fade that portion of the screen that lies in this region.
  4540.  
  4541.  
  4542.         Comments:
  4543.         --------
  4544.  
  4545.         WINDOW has no effect on the CFADE command.
  4546.  
  4547.  
  4548.  
  4549.  
  4550.  
  4551.  
  4552.  
  4553.  
  4554.  
  4555.  
  4556.  
  4557.  
  4558.  
  4559.  
  4560.  
  4561.  
  4562.  
  4563.  
  4564.  
  4565.  
  4566.                    GRASP - Graphical System for Presentation
  4567.                                    Page:  71
  4568.  
  4569.  
  4570.  
  4571.  
  4572.  
  4573.  
  4574.                       Tips, Hints, Examples and Demo Programs
  4575.  
  4576.  
  4577.  
  4578.  
  4579.  
  4580.  
  4581.  
  4582.  
  4583.  
  4584.  
  4585.  
  4586.  
  4587.  
  4588.  
  4589.  
  4590.  
  4591.  
  4592.  
  4593.  
  4594.  
  4595.  
  4596.  
  4597.  
  4598.  
  4599.  
  4600.  
  4601.  
  4602.  
  4603.  
  4604.  
  4605.  
  4606.  
  4607.  
  4608.  
  4609.  
  4610.  
  4611.  
  4612.  
  4613.  
  4614.  
  4615.  
  4616.  
  4617.  
  4618.  
  4619.  
  4620.  
  4621.  
  4622.  
  4623.  
  4624.  
  4625.  
  4626.  
  4627.                    GRASP - Graphical System for Presentation
  4628.                                    Page:  72
  4629.  
  4630.  
  4631.  
  4632.  
  4633.  
  4634.  
  4635.                         This page intentionally left blank
  4636.  
  4637.  
  4638.  
  4639.  
  4640.  
  4641.  
  4642.  
  4643.  
  4644.  
  4645.  
  4646.  
  4647.  
  4648.  
  4649.  
  4650.  
  4651.  
  4652.  
  4653.  
  4654.  
  4655.  
  4656.  
  4657.  
  4658.  
  4659.  
  4660.  
  4661.  
  4662.  
  4663.  
  4664.  
  4665.  
  4666.  
  4667.  
  4668.  
  4669.  
  4670.  
  4671.  
  4672.  
  4673.  
  4674.  
  4675.  
  4676.  
  4677.  
  4678.  
  4679.  
  4680.  
  4681.  
  4682.  
  4683.  
  4684.  
  4685.  
  4686.  
  4687.  
  4688.                    GRASP - Graphical System for Presentation
  4689.                                    Page:  73
  4690.  
  4691.  
  4692.  
  4693.  
  4694.  
  4695.  
  4696.         Example Program #1 - Slide Show
  4697.         -------------------------------
  4698.  
  4699.         A simple  slideshow can  be constructed by creating a grasp command
  4700.         file as follows:
  4701.  
  4702.  
  4703.         ; Slideshow demo for GRASP
  4704.         ;
  4705.         ; This program will load and display 4 pictures, alternating
  4706.         ; between fade #1 and fade #2, waiting for a count of 500 between
  4707.         ; each fade.
  4708.         ;
  4709.          video a             ; set medium res 4 color CGA mode (this can
  4710.                              ; be whatever mode you want to use)
  4711.         ;
  4712.          load pic1           ; load pic1 into buffer 1
  4713.          fade 1              ; fade using fade number 1
  4714.          waitkey 500         ; wait for a count of 500
  4715.         ;
  4716.          load pic2           ; load pic2 into buffer 1
  4717.          fade 2              ; but use fade #2 this time.
  4718.          waitkey 500         ; etc...
  4719.         ;
  4720.          load pic3
  4721.          fade 1
  4722.          waitkey 500
  4723.         ;
  4724.          load pic4
  4725.          fade 2
  4726.          waitkey 500
  4727.         ;
  4728.          exit                ; quit the program
  4729.  
  4730.  
  4731.  
  4732.  
  4733.  
  4734.  
  4735.  
  4736.  
  4737.  
  4738.  
  4739.  
  4740.  
  4741.  
  4742.  
  4743.  
  4744.  
  4745.  
  4746.  
  4747.  
  4748.  
  4749.                    GRASP - Graphical System for Presentation
  4750.                                    Page:  74
  4751.  
  4752.  
  4753.  
  4754.  
  4755.  
  4756.  
  4757.         Example Program #2 - How to animate using FLY
  4758.         ---------------------------------------------
  4759.  
  4760.         Let's say  you have  2 clippings  which are  a flock  of birds with
  4761.         wings up and wings down. To fly them across the screen, (from 0,160
  4762.         to 300,160 issue the following sequence:
  4763.  
  4764.  
  4765.          tran on 3      ; turn transparent mode on
  4766.                         ; (this assumes the background is color 3.)
  4767.         ;
  4768.          cload birds1,1                ; load in first clip
  4769.          cload birds2,2                ; load in second clip
  4770.          fly 0,160,300,160,3,4,1,2     ; fly 'em!
  4771.         ;
  4772.          tran off       ; turn off transparent mode
  4773.  
  4774.         The parameters  in the  fly command  are x1,y1,x2,y2,step(number of
  4775.         pixels between each putup),delay(time of delay between each putup),
  4776.         and list of clippings, in this case, 1 and 2.
  4777.  
  4778.  
  4779.  
  4780.  
  4781.  
  4782.  
  4783.  
  4784.  
  4785.  
  4786.  
  4787.  
  4788.  
  4789.  
  4790.  
  4791.  
  4792.  
  4793.  
  4794.  
  4795.  
  4796.  
  4797.  
  4798.  
  4799.  
  4800.  
  4801.  
  4802.  
  4803.  
  4804.  
  4805.  
  4806.  
  4807.  
  4808.  
  4809.  
  4810.                    GRASP - Graphical System for Presentation
  4811.                                    Page:  75
  4812.  
  4813.  
  4814.  
  4815.  
  4816.  
  4817.  
  4818.         APPENDIX A - Command Summary
  4819.  
  4820.  
  4821.         Notes:
  4822.         -----
  4823.  
  4824.         Each  command's  arguments  (if  any) are  separated by  commas  or
  4825.         spaces, whichever is preferable.
  4826.  
  4827.         Comments  begin  at  a  semicolon  and continue for the rest of the
  4828.         line.
  4829.  
  4830.         Line  labels  are  up  to  16  characters  long  and  end   with  a
  4831.         colon,i.e.,<label>:.
  4832.  
  4833.         Subroutines can be nested up to 16 levels deep.
  4834.  
  4835.         There can be up to 16 levels of nesting in MARK,LOOP constructions.
  4836.  
  4837.         CAPITAL letters are the command name. It must be spelled correctly,
  4838.         but capitals are not required.
  4839.  
  4840.         LOWERCASE letters and numbers are parameters. You must  specify all
  4841.         required parameters, (those not enclosed in <>), or you will get an
  4842.         error message indicating too few parameters.
  4843.  
  4844.  
  4845.  
  4846.  
  4847.  
  4848.  
  4849.  
  4850.  
  4851.  
  4852.  
  4853.  
  4854.  
  4855.  
  4856.  
  4857.  
  4858.  
  4859.  
  4860.  
  4861.  
  4862.  
  4863.  
  4864.  
  4865.  
  4866.  
  4867.  
  4868.  
  4869.  
  4870.  
  4871.                    GRASP - Graphical System for Presentation
  4872.                                    Page:  76
  4873.  
  4874.  
  4875.  
  4876.  
  4877.  
  4878.  
  4879.         Command Summary:
  4880.         ---------------
  4881.         BOX x,y,x2,y2,<width>                 - draw a box
  4882.         CFADE #,x,y,<buffer>,<speed>,<delay>  - fade a clipping to screen
  4883.         CFREE buffer,<buffer>,...             - free up clipping buffer(s)
  4884.         CHGCOLOR from,to,<from,to>,...        - EGA, change color index
  4885.         CIRCLE x,y,rx,<ry>                    - draw an ellipse
  4886.         CLEARSCR                              - clear screen
  4887.         CLOAD clipping filename,<buffer>      - load a clipping
  4888.         COLOR color1,<color2>                 - set color 1 & color 2
  4889.         EXEC program,<parameters>             - execute program from GRASP
  4890.         EXIT                                  - quit program
  4891.         FFREE                                 - free the font buffer
  4892.         FGAPS <char_gap, space_gap>           - set text gaps
  4893.         FLOAD character set filename          - load a font
  4894.         FLOAT xs,ys,xe,ye,step,delay,clp1...  - float clip across screen
  4895.         FLY xs,ys,xe,ye,step,delay,clp1...    - fly clip across screen
  4896.         FSTYLE style                          - set text style
  4897.         GOSUB label                           - execute subroutine
  4898.         GOTO label                            - goto label
  4899.         IFKEY key,label                       - if key match, goto label
  4900.         LINE x,y,x2,y2                        - draw line
  4901.         LINK textfile filename                - link to another text file
  4902.         LOOP                                  - loop to previous mark
  4903.         MARK loop count                       - mark for looping
  4904.         MODE border color,<palette>           - CGA border & palette set
  4905.         MOVE x0,y0,x1,y1,dx0,dy0              - move a region of the screen
  4906.         NOISE freq1,freq2,duration            - make some noise
  4907.         OFFSET x,y,<r>                        - set x and y offsets
  4908.         PALETTE buffer                        - EGA mode set palette
  4909.         PAN x0,y0,x1,y1,<buffer>              - EGA pan from x0,y0 to x1,y1
  4910.         PFADE #,<buffer>,<speed>,<delay>      - fade a picture to screen
  4911.         PFREE buffer,<buffer>,...             - free up picture buffer(s)
  4912.         PLOAD picture filename,<buffer>       - load a picture
  4913.         POINT x,y,<x2,y2>                     - draw a point
  4914.         POSITION buffer,x,y,<r>               - set position in page
  4915.         PUTUP x,y,<buffer>,<delay>            - put a clip to screen @ x,y
  4916.         RECT x,y,x1,y1                        - draw a filled rectangle
  4917.         RESETSCR                              - reset screen to default
  4918.         RETURN                                - return from subroutine
  4919.         SETCOLOR c1,c2,c3...c16               - EGA mode set 16 colors
  4920.         SETUPSCR buffer                       - Set up screen for PAN  
  4921.         TEXT x,y,"some text",<delay>          - put up text @ x,y
  4922.         TILE buffer                           - tile screen with clipping
  4923.         TRAN on/off, color                    - transparent mode on/off
  4924.         VIDEO vidmode                         - set video mode
  4925.         WAITKEY <timeout>, <label>            - wait for a keypress
  4926.         WINDOW x0,y0,x1,y1                    - set clip window
  4927.  
  4928.  
  4929.  
  4930.  
  4931.  
  4932.                    GRASP - Graphical System for Presentation
  4933.                                    Page:  77
  4934.  
  4935.  
  4936.  
  4937.  
  4938.  
  4939.  
  4940.         APPENDIX B - Fade Table
  4941.  
  4942.         There are 25 fades  in GRASP  which must  be called  by number. All
  4943.         fades  work  on  graphics  screens,  graphics  screens in a window,
  4944.         clippings  and  text  screens.  This  list  is  also  accessable by
  4945.         pressing F3 while in the GRASP editor.
  4946.  
  4947.         Fade # Description
  4948.         ------ -------------------------------------------------------
  4949.           0    Quick snap wipe
  4950.           1    Horizontal left to right wipe
  4951.           2    Horizontal right to left wipe
  4952.           3    Horizontal edge to center wipe
  4953.           4    Horizontal center to edge wipe
  4954.           5    Horizontal 1 pass filter wipe - both sides simultaneously
  4955.           6    Horizontal 2 pass filter wipe - from left, then from right
  4956.           7    Horizontal halves wipe - left to right, then right to left
  4957.           8    Horizontal halves wipe - left and right simultaneously
  4958.           9    Vertical top to bottom wipe
  4959.          10    Vertical bottom to top wipe
  4960.          11    Vertical edge to center wipe
  4961.          12    Vertical center to egde wipe
  4962.          13    Vertical filter wipe, top and bottom simultaneously
  4963.          14    Vertical halves wipe, top and bottom simultaneously
  4964.          15    Vertical halves wipe, left down, right up
  4965.          16    Vertical quarters wipe
  4966.          17    Vertical fingers wipe
  4967.          18    Vertcial fingers/filter combination wipe
  4968.          19    Slither from top to bottom
  4969.          20    Sparkle fade (random)
  4970.          21    Diagonal wipe
  4971.          22    Aperature dissolve - edge to center
  4972.          23    Aperature dissolve - center to edge
  4973.          24    Clockwise clock dissolve
  4974.          25    Double slant dissolve
  4975.  
  4976.  
  4977.  
  4978.  
  4979.  
  4980.  
  4981.  
  4982.  
  4983.  
  4984.  
  4985.  
  4986.  
  4987.  
  4988.  
  4989.  
  4990.  
  4991.  
  4992.  
  4993.                    GRASP - Graphical System for Presentation
  4994.                                    Page:  78
  4995.  
  4996.  
  4997.  
  4998.  
  4999.  
  5000.  
  5001.                         This page intentionally left blank
  5002.  
  5003.  
  5004.  
  5005.  
  5006.  
  5007.  
  5008.  
  5009.  
  5010.  
  5011.  
  5012.  
  5013.  
  5014.  
  5015.  
  5016.  
  5017.  
  5018.  
  5019.  
  5020.  
  5021.  
  5022.  
  5023.  
  5024.  
  5025.  
  5026.  
  5027.  
  5028.  
  5029.  
  5030.  
  5031.  
  5032.  
  5033.  
  5034.  
  5035.  
  5036.  
  5037.  
  5038.  
  5039.  
  5040.  
  5041.  
  5042.  
  5043.  
  5044.  
  5045.  
  5046.  
  5047.  
  5048.  
  5049.  
  5050.  
  5051.  
  5052.  
  5053.  
  5054.                    GRASP - Graphical System for Presentation
  5055.                                    Page:  79
  5056.  
  5057.  
  5058.  
  5059.  
  5060.  
  5061.  
  5062.         APPENDIX C - Error Messages
  5063.  
  5064.         The following  is a  list of  messages you  may get while executing
  5065.         GRASP and some of their causes and solutions.
  5066.  
  5067.  
  5068.         MOST COMMON ERRORS:
  5069.  
  5070.  
  5071.         I.    The most common error is not  a  grasp  program  error  but a
  5072.               system  error.  The  screen  will  clear, and you will get an
  5073.               error like
  5074.  
  5075.          External Memory allocation overflow, xxxxk requested, yyyyk free.
  5076.  
  5077.               This means that you have tried to load a picture  or clipping
  5078.               that is  too large  for the  memory you  have left. There are
  5079.               several fixes for this problem.
  5080.               1) Buy more memory. EGA 16 color demos usually take most of a
  5081.               640K machine
  5082.               2) Check your code and use PFREE, CFREE and FFREE to clean up
  5083.               memory  when  you  are  through  using  particular  pictures,
  5084.               clippings and  fonts. See  the section of the manual on these
  5085.               commands.
  5086.               3) Use the special parameter,  ',1'  on  clipping  loads that
  5087.               don't make the shifted copies. In order to be able to PUTUP a
  5088.               clipping at any single-pixel coordinate, GRASP  needs to make
  5089.               up to  8 shifted  copies of the clipping. If you are going to
  5090.               be using CFADE or putting it up at a byte  boundary, then the
  5091.               shifted copies aren't necessary. You can keep them from being
  5092.               generated by typing:
  5093.  
  5094.               CLOAD clip,1,1 ;note the extra ',1'
  5095.  
  5096.               If you do specify the extra parameter, and you try  to put up
  5097.               the  clipping  at  a  non-byte boundary, no putup will occur.
  5098.               Remember, FLY, FLOAT  and  PUTUP  can  put  clippings  at any
  5099.               coordinate. CFADE can only putup at a byte boundary.
  5100.  
  5101.               If  none  of  the  above  three work, then call the GRASP and
  5102.               PCPAINT BBS for more advice.
  5103.  
  5104.  
  5105.  
  5106.  
  5107.  
  5108.  
  5109.  
  5110.  
  5111.  
  5112.  
  5113.  
  5114.  
  5115.                    GRASP - Graphical System for Presentation
  5116.                                    Page:  80
  5117.  
  5118.  
  5119.  
  5120.  
  5121.  
  5122.  
  5123.         II. System Errors
  5124.  
  5125.          The following is a list of  the GRASP  system errors  that you may
  5126.         encounter. These will appear on the top of the screen while running
  5127.         your demo along with a line number where  the error  occurred. When
  5128.         you press a key, you will be returned to that line in your program.
  5129.         If you get the error while running under  the runtime  version, the
  5130.         program will stop.
  5131.  
  5132.  
  5133.  
  5134.         DUPLICATE LABEL 
  5135.  
  5136.         - You have used the same label name more than once in your demo and
  5137.         GRASP is confused.
  5138.  
  5139.  
  5140.         ERROR IN LOOP COUNT
  5141.  
  5142.          - Loop count must be  a positive  number. This  error occurs  if a
  5143.         negative number was specified.
  5144.  
  5145.  
  5146.         ERROR IN NAME
  5147.  
  5148.          - You have  used an  invalid character  in a filename, or the file
  5149.         GRASP was trying to load was not found.
  5150.  
  5151.  
  5152.         ERROR IN PACKED CLIPPING
  5153.  
  5154.          - sometimes, clippings may be trashed  or  someone  tries  to load
  5155.         some other  file with a .CLP extension. If GRASP does not recognize
  5156.         a clipping as being  a  valid  clipping  file,  you  will  get this
  5157.         message.
  5158.  
  5159.  
  5160.         ERROR IN XCOORD
  5161.  
  5162.          - The Y-coordinate  lies off  the screen.  This may occur after an
  5163.         OFFSET command. If you specify 0 for the Y coordinate, but Y offset
  5164.         is set to -5, you will get this error.
  5165.  
  5166.  
  5167.         ERROR IN YCOORD
  5168.  
  5169.          - The Y-coordinate  lies off  the screen.  This may occur after an
  5170.         OFFSET command. If you specify 0 for the Y coordinate, but Y offset
  5171.         is set to -5, you will get this error.
  5172.  
  5173.  
  5174.  
  5175.  
  5176.                    GRASP - Graphical System for Presentation
  5177.                                    Page:  81
  5178.  
  5179.  
  5180.  
  5181.  
  5182.  
  5183.  
  5184.         ERROR LOADING FONT
  5185.  
  5186.          - GRASP doesn't  recognize the  font you  are trying to load. Also
  5187.         could be too large for memory or hardware error during load.
  5188.  
  5189.  
  5190.         ERROR LOADING PICTURE
  5191.  
  5192.          - GRASP doesn't recognize the picture you are trying to load. Also
  5193.         could be hardware error during load.
  5194.  
  5195.  
  5196.         ERROR LOADING TEXT
  5197.  
  5198.          - GRASP doesn't recognize the text file you are trying to link to.
  5199.         Also could be hardware during load.
  5200.  
  5201.  
  5202.         ILLEGAL ARGUMENT(S)
  5203.  
  5204.          - One  of  the  arguments  for  the  current  command  is invalid.
  5205.         Examples are invalid video mode, etc.
  5206.  
  5207.  
  5208.         ILLEGAL BUFFER
  5209.  
  5210.          - You  have  specified  a  buffer  number that is outside of valid
  5211.         range. Buffers are 1-16 for pictures and 1-128  for clippings. Also
  5212.         may get  this when  an error occurs trying to allocate a new buffer
  5213.         during load.
  5214.  
  5215.  
  5216.         ILLEGAL COLOR
  5217.  
  5218.          - You have specified an invalid color number for this video mode.
  5219.  
  5220.  
  5221.         ILLEGAL FADE
  5222.  
  5223.          - You have specified an invalid fade number. Valid fades are 0-25.
  5224.  
  5225.  
  5226.         ILLEGAL PALETTE
  5227.  
  5228.          - You have  specified an  invalid palette  number for  CGA 4 color
  5229.         mode. Valid palettes are 0-5.
  5230.  
  5231.  
  5232.         ILLEGAL SPEED
  5233.  
  5234.          - You have specified an invalid speed for a fade. Valid speeds are
  5235.         0-10000.
  5236.  
  5237.                    GRASP - Graphical System for Presentation
  5238.                                    Page:  82
  5239.  
  5240.  
  5241.  
  5242.  
  5243.  
  5244.  
  5245.         INVALID FONT STYLE
  5246.  
  5247.          - You have specified an  invalid font  style number.  Valid styles
  5248.         are 0-6.
  5249.  
  5250.  
  5251.         INVALID GAP VALUE
  5252.  
  5253.          - You have specified an invalid GAP value. Range is 0-255.
  5254.  
  5255.  
  5256.         LABEL NOT FOUND
  5257.  
  5258.          - You have  tried to  reference a  label which  was not previously
  5259.         defined.
  5260.  
  5261.  
  5262.         MEMORY ERROR
  5263.  
  5264.          - When trying to allocate the memory for your  GRASP command file,
  5265.         an error  was encountered. Usually only happens when a command file
  5266.         is too large.
  5267.  
  5268.  
  5269.         NOT ENOUGH ARGUMENTS
  5270.  
  5271.          - Certain commands require a minimum number of arguments. You need
  5272.         to specify some more.
  5273.  
  5274.  
  5275.         THIS COMMAND REQUIRES AN EGA
  5276.  
  5277.          - Just like  it says, this particular command requires an EGA card
  5278.         and EGA video mode to operate.
  5279.  
  5280.  
  5281.         TOO MANY LOOPS
  5282.  
  5283.          - You have nested your loops deeper than the maximum, which is 16,
  5284.         or you have more loop commands that mark commands.
  5285.  
  5286.  
  5287.         TOO MANY MARKS
  5288.  
  5289.          - You have nested your loops deeper than the maximum, which is 16,
  5290.         or you have more mark commands than loop commands.
  5291.  
  5292.  
  5293.         UNKNOWN COMMAND
  5294.  
  5295.          - GRASP found something that was not  a comment,  not a  label and
  5296.         couldn't recognize as a valid command. Check your spelling.
  5297.  
  5298.                    GRASP - Graphical System for Presentation
  5299.                                    Page:  83
  5300.  
  5301.  
  5302.  
  5303.  
  5304.  
  5305.  
  5306.         APPENDIX D - Picture Swap Line
  5307.  
  5308.  
  5309.         There is  a public  domain electronic bulletin board which operates
  5310.         24 hours a day with the sole purpose of providing a method by which
  5311.         users of PCPAINT and GRASP may exchange pictures, clippings, fonts,
  5312.         effects and ideas. This help eliminate the extra  cost of providing
  5313.         artwork for  many of  the GRASP  demos you  may want to create. The
  5314.         most current version of GRASP will be avaliable this system.
  5315.  
  5316.         All uploads and downloads are free  and may  be used  by anyone. We
  5317.         encourage you  to contribute  any artwork you feel could be used by
  5318.         someone else. Of  course  there  will  be  proprietary  artwork you
  5319.         either pay  to have  developed, or  need to  keep confidential. But
  5320.         your discards may be another's joy...
  5321.  
  5322.         The BBS is located in Costa Mesa, California, and the number is
  5323.  
  5324.                            ***    (714) 545-8100    ***
  5325.  
  5326.         You will be limited to 1 hour of use per  day. We  suggest that you
  5327.         use 1200  or 2400 baud modems set at 8 bits, 1 stop bit, no parity.
  5328.         You will be transferring binary files so the 8 bit mode is  a must.
  5329.         There are  several utility programs you will want to download first
  5330.         which allow you to squeeze and unsqueeze the pic files so that they
  5331.         will not  take as  much time  to upload and download. You will find
  5332.         them in the UTILITY file area.
  5333.  
  5334.  
  5335.         Thanks in advance for your support and contributions to the board.
  5336.  
  5337.  
  5338.  
  5339.  
  5340.  
  5341.  
  5342.  
  5343.  
  5344.  
  5345.  
  5346.  
  5347.  
  5348.  
  5349.  
  5350.  
  5351.  
  5352.  
  5353.  
  5354.  
  5355.  
  5356.  
  5357.  
  5358.  
  5359.                    GRASP - Graphical System for Presentation
  5360.                                    Page:  84
  5361.  
  5362.  
  5363.  
  5364.  
  5365.  
  5366.  
  5367.                         This page intentionally left blank
  5368.  
  5369.  
  5370.  
  5371.  
  5372.  
  5373.  
  5374.  
  5375.  
  5376.  
  5377.  
  5378.  
  5379.  
  5380.  
  5381.  
  5382.  
  5383.  
  5384.  
  5385.  
  5386.  
  5387.  
  5388.  
  5389.  
  5390.  
  5391.  
  5392.  
  5393.  
  5394.  
  5395.  
  5396.  
  5397.  
  5398.  
  5399.  
  5400.  
  5401.  
  5402.  
  5403.  
  5404.  
  5405.  
  5406.  
  5407.  
  5408.  
  5409.  
  5410.  
  5411.  
  5412.  
  5413.  
  5414.  
  5415.  
  5416.  
  5417.  
  5418.  
  5419.  
  5420.                    GRASP - Graphical System for Presentation
  5421.                                    Page:  85
  5422.  
  5423.  
  5424.  
  5425.  
  5426.  
  5427.  
  5428.         APPENDIX E - GRASP Order Form                 
  5429.  
  5430.         GRASP is distributed in the USEware format. If you are going to USE
  5431.         it, please  check the  appropriate box below and enclose a check or
  5432.         purchase order. If you find the program unUSEable, please drop us a
  5433.         line telling  us why. If you pay for the program by sending in this
  5434.         registration form with a check or money order, you will be added to
  5435.         our  mailing  list  and  be  kept  notified of new releases and new
  5436.         utilities.
  5437.  
  5438.         ------------------------------------------------------------------
  5439.  
  5440.         Single-User Order Form
  5441.         ======================
  5442.  
  5443.         If you are going to pay for less than 50 copies, use this form. The
  5444.         single  user  price  is  $50.00. California residents please add 6%
  5445.         sales tax. You must pay for EACH copy you plan to use.
  5446.  
  5447.         Full Name:__________________________  ___  Copies @ $50.00=________
  5448.  
  5449.         Address  :__________________________        6% Sales Tax=_________
  5450.  
  5451.                  :__________________________      Total Enclosed=_________ 
  5452.  
  5453.         City     :____________________________ St:_____ Zip:______________
  5454.  
  5455.         (Internal Use Only) BBS or Hot-Spot_______________________________
  5456.  
  5457.  
  5458.  
  5459.  
  5460.  
  5461.  
  5462.  
  5463.  
  5464.  
  5465.  
  5466.  
  5467.  
  5468.  
  5469.  
  5470.  
  5471.  
  5472.  
  5473.  
  5474.  
  5475.  
  5476.  
  5477.  
  5478.  
  5479.  
  5480.  
  5481.                    GRASP - Graphical System for Presentation
  5482.                                    Page:  86
  5483.  
  5484.  
  5485.  
  5486.  
  5487.  
  5488.  
  5489.  
  5490.         Corporate Site License Information Form
  5491.         =======================================
  5492.         If you are going to be using in excess of 50 copies of GRASP within
  5493.         your company at one site, (5 mile radius from licensing party), you
  5494.         need  only  pay  for  the  first  50  copies. You may then make and
  5495.         distribute to your employees an unlimited  number of  copies of the
  5496.         software and manual. This applies to Computer User Groups as well. 
  5497.  
  5498.         ------------------------------------------------------------------
  5499.  
  5500.  
  5501.         ____ Yes,  I would like more information on Corporate or User Group
  5502.              Licensing. Please call me at the number listed below.
  5503.  
  5504.         Primary Contact for updates, etc.:
  5505.  
  5506.         Full Name :_________________________   
  5507.  
  5508.         Address   :_________________________        
  5509.  
  5510.                   :_________________________   
  5511.             
  5512.         Department:_________________________   
  5513.  
  5514.         City      :___________________________ St:_____  Zip:_____________
  5515.  
  5516.         Phone:_______________________  Ext:_____________  Date:___________
  5517.  
  5518.  
  5519.  
  5520.  
  5521.  
  5522.  
  5523.  
  5524.  
  5525.  
  5526.  
  5527.  
  5528.  
  5529.  
  5530.  
  5531.  
  5532.  
  5533.  
  5534.  
  5535.  
  5536.  
  5537.  
  5538.  
  5539.  
  5540.  
  5541.  
  5542.                    GRASP - Graphical System for Presentation
  5543.                                    Page:  87
  5544.  
  5545.